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For a device that can fit in the palm of your hand, the Raspberry Pi has had 
a pretty colossal impact since its launch in 2012, In just a few short years it's 
changed the way computer science is taught in schools, it's been used in some 
amazing projects at Raspberry Jam events across the world, and it's inspired 
a new generation of coders to create and craft new gadgets. No matter your 
age or experience level, there's a Pi project for you, and in Practical Raspberry Pi 
Projects we're giving you everything you need to fire up your imagination and 
unleash your creativity. From hardware-based projects like building a Raspberry 
Pi-controlled car, through software projects like programming your own 
virtual assistant, all the way to advanced electronics projects that will see you 
transforming your Pi into a drum machine, car computer or quadcopter, we've got 
plenty here to keep you busy. All you need is your favourite $35 computer and a 

passion for making things! 
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From our time covering this incredible credit card- 
sized computer, it’s become clear there are two types 
of Raspberry Pi owners: those that use theirs and those 
that don’t. Whether it’s fear of the unknown, a lack of time 
or inspiration, when we ask people what they do with their 
Pi we’ll often hear that it’s still in the box. If that’s you, then 
you're in the right place. In this feature we’ve handcrafted ten 
Raspberry Pi projects practically anyone can enjoy, 

These aren’t just a random selection of side-projects, though, 
These are practical ideas designed to help kick-start bigger 
and better things. Knowledge gained from one project can also 
be applied to another to create something completely new. For 
example, you could combine our Twitter and three-colour lamp 
tutorials to create a desk lamp that changes colour as your 
Twitter account is retweeted. You could go on to make Pong in 
Minecraft-Pi or use a button attached to Scratch to take photos 
with your Raspberry Pi camera moduLe. The list goes on. 

All these projects are open source, so you’re encouraged to 
tweak and develop them into something entirely new. If you 
share your tweaks and changes with the community, you’re sure 
to start benefittingfrom doingthingsthe open source way... 


Code your own 
Twitter bat 
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Program your own melodies using Sonic Pi and create 
musical cues or robot beeps 


WhatyouH need 


■ Portable speakers 

■ Sonic Pi 



One of the major features of Scratch is 
its ability to teach the fundamentals 
of coding to kids and people with no 
computing background. For kids, its 
especially appealing due to the way it 
allows them to create videogames to 
interact with as part of their learning. In 
this kind of vein then, Sonic Pi teaches 
people to code using music. With a 
simple language that utilises basic logic 
steps but in a more advanced way than 
Scratch, it can either be used as a next 
step for avid coders, or as a way to create 
music for an Internet of Things or a robot. 


GettingSonic Pi 

f you’ve installed the latest version of Raspbian, Sonic 
Pi will be included by default. If you’re still using a slightly older 
version, then you’ll need to install it via the repos. Do this with: 

$ sudo apt-get install sonic-pi 



■ Sonic Pi is a great way 
to learn basic coding 
pri nci pies and have f u n 








MAKE MUSIC WITH THE RASPBERRY PI 


F We can start making more 
complex melodies by using more 
of Sonic Pi’s functions 


Starting with Sonic Pi 

Sonic Pi is located in the Education category in the 
menus. Open it up and you’ll be presented with something that 
looks like an IDE. The paneontheleftallowsyoutoenterthecode 
for your project with proper syntax highlighting for its own style 
of language. When running, an info pane details exactly what’s 
being played via Sonic Pi - and any errors are listed in their own 
pane as well, forreference. 



Your first note 

Our first thing to try on Sonic Pi is simply being able 
to play a note. Sonic Pi has a few defaults preset, so we can get 
started with: 
play 50 

Press the Play button and the output window will show you what’s 
being played. The pretty_bell sound is the default tone for Sonic 
Pi’s output, and 50 determines the pitch and tone of the sound. 

Full code listing 

with_tempo 200 

play.pattern [40, lb,- 45, 25, 25, 50,50] 

2. times do 

with.synth “beep” 

play.pattern [ 0, 5,4: , 25, ", , it] 

play.pattern [40,25,4! ,25, 25, 50, 50], reverse 

end 

play.pad “saws”, 3 

in.thread do 

with.synth “fm” 

6. times do 

if rand < 0.5 

play 30 

else 

play 50 

end 

sleep 2 

end 

end 

2. times do 

play.synth “pretty.bell” 
play.pattern [-0,25, ,25,25,50, ] 

play.pattern [40,25,1 ,25, 25, 50, 50]. reverse 

end 



Set the beat 

For any piece of music, you’ll want to set the tempo. We 
can start by putting: 

| with.tempo 200 

...at the start of our code. We can test it out bycreatinga stringof 
midi notes using play.pattern: 
play.pattern [40,25,45,25,25,50,50] 

This will play pretty.bell notes at these tones at the tempo we've 
set You can create longer and shorter strings, and also change 
the way they play. 



kMa* # ■■ 

i withjttupo 230 


pUy_p*ttern [40,25,45,25,25,50,501 
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with synth 
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4$| 

play_pattern { 10, 25,45,25,25,50,50] 
p\ay_pattern ( 40 , 25, 4b , 2b , 25,50,50) * ra verst 
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Advance your melody 

We can start making more complex melodies by using 
more of Sonic Pi’s functions. You can change the note type by 
using with.synth, reverses pattern, and even create a finite loop 
with the x.times function; do and end signify the start and end 
of the loop. Everything is played in sequence before repeating, 
much like an if or while loop in normal code. 



Playing a concert 

Using the in.thread function, we can create another 
thread for the Sonic Pi instance and have several lines of musical 
code play at once instead of in sequence. We’ve made it create 
a series of notes in a random sequence, and have them play 
alongside extra notes created by the position and velocity of the 
mouse using the play.pad function. 







You’ll 

learn... 



1. How 
to code 

The coding 
style of Sonic Pi 
uses concepts 
from standard 
programming 
languages - if 
statements, loops, 
threads etc. Whereas 
Scratch teaches this 
logic. Sonic Pi teaches 
their structure. 

2. Robotic 
voice 

Employ Sonic Pi 
to create context- 
sensitive chips, chirps 
and beeps and use 
it to give a familiar 
voice while it tootLes 
around. 

3. MIDI 

The Musical 
Instrument Digital 
Interface is a 
standard for digital 
music, and the 
numbers and tones 
used in Sonic Pi make 
use of this. 


10 PRACTICAL RASPBERRY PI PROJECTS 



■ It’s easier to make your Raspberry Pi talk 
than you might think, thanks to eSpeak 



What youH need 

■ Portable USB speakers 

■ python-espeak module 

■ eSpeak 

Raspbian (latest image) 


We’ve shown in previous issues how 
the Raspberry Pi can be used to 
power robots, and as a tiny computer 
it can also be the centre of an Internet 
of Things in your house or office. 
For these reasons and more, using 
the Raspberry Pi for text-to-voice 
commands could be just what you’re 
looking for. Due to the Debian base 
of Raspbian, the powerful eSpeak 
library is easily available for anyone 
looking to make use of it. There's also a 
module that allows you to use eSpeak 
in Python, going beyond the standard 
command-line prompts so you can 
perform automation tasks. 



Everyth ingyou’U need 

I We’ll install everything weplantouseinthistutoriaLat 
once. This includes the eSpeak library and the Python modules 
we need to show it off. Open the terminal and install with: 

$ sudo apt-get install espeak python-espeak python-tk 








RASPBERRY PI VOICE SYNTHESIZER 



You can change the way eSpeak 
will read text with a number of 
different options 



Pi’s first words 

\i^m The eSpeak library is pretty simple to use - to get it to 
just say something, type in the terminal: 

| $ espeak “[message]” 

This will use the library’s defaults to read whatever is written in 
the message, with decent clarity. 


Say some more 

You can change the way eSpeak will read text with a 
number of different options, such as gender, read speed and 
even the way it pronounces syllables. For example, writing the 
command like so: 


t $ espeak -ven+f3 -k5 -sl50 “[message]” 

...will turn the voice female, emphasise capital letters and make 
the reading slower. 


*" , «4MI fUIM U * 

L*t £* Farm* gpum I*4Mn 




IOC «lid rill ( | A . ^.wii 1 , * . » ! # # ■*' • i ’• k . * - » E * r - i - mi «1 I U*3 'ftp* ij. il | *) 



A/ Takingcommand with Python 

Vr*T The most basic way to use eSpeak in Python is to use 
subprocess to directly call a command-line function. Import 
subprocess in a Python script, then use: 
f subprocess. call([“espeak”, “[options 1]”, “[option *- J 
2]" ...’’[option rO" “[message]”) 

The message can be taken from a variable. 


The native tongue 

The Python eSpeak module is quite simple to use to just 
convert some text to speech. Try this sample code: 

from espeak import espeak 
espeak. synth (“[message]”) 

You can then incorporate this into Python, like you would any 
other module, for automation. 





A voice synthesiser 

w Using the code listing, we’re creating a simple interface 
with Tkinter with some predetermined voice buttons and a 
custom entry method. We’re showing how the eSpeak module 
can be manipulated to change its output. This can be used for 
reading tweets or automated messages. Have fun! 


Full code listing 


Import the 
necessary eSspeak 
and GUI modules, as 
well as the module 
to find outthetime 


from espeak import espeak 

from Tkinter import * 

from datetime import datetime 

def hello_worldQ: 

espeak. synthQHello World”) 



Define the different 
functions that the 
interface will, use, 
including a simple 
fixed message, 
teliingthe time, and 
a custom message 


def time,now(): 

t - datetime. now(),strftime(“%k %M”) 
espeak. synthQThe time is 

def read_fext(): 

text_to_read = input m text,get() 
espeak. sy nth (text_to„read) 


Create the basic 
window with Tkinter 
for your interface, 
as well as creating 
the variable for 
text entry 


root = Tk() 

root.titleQVoice box”) 
input_text - StringVar() 

box = Frame(root, height = 200, width = 500) 

box.pack_propagate(0) 

box,pack(padx - 5, pady = 5) 


The text entry 
appends to the 
variable we 
created, and each 
button calls a 
specific function 
that we defined 
above in the code 


Labeifbox, text-”Enter text”) . pack() 
entry^text = Entry (box, exportselection = 0, 
textvariable - input^text) 
entry_text.pack() 

entry^ready - Button(box, text - “Read this”, 
command = read_text) 
entry^ready. packQ 

hello_button = Button(box, text = “Hello World”, 

command = hello_world) 

helio_buttorLpack() 

time^button - Buttom(box, text = “What J s the +- 
time?”, command - time_now) 
time^but ton. packQ 

root .mainloopQ 
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Learn to program while playing one of the 
oreatest games ever made! 


What you'll need 

■ Raspbian (latest release) 

■ Minecraft-Pi tarball 

■ Keyboard & mouse 

■ Internet connection 


Minecraft is probably the biggest game 
on the planet right now. It’s available on 
just about any format you can imagine, 
from PCs to gaming consoles to mobile 
phones. It should probably come as 
no surprise that it’s also available on 
the Raspberry Pi. While at first glance 
Minecraft-Pi is a simplified version of the 
Pocket Edition (designed for tablets and 
smartphones), the Raspberry Pi edition 
is very special, in that it’s the only version 
of Minecraft to gives users access to its 
API (application programming interface). 

In this project we’re going to show you 
how to set up Minecraft-Pi and configure 
it so you can interact with Minecraft in a 
way you’ve never done before. This small 
project is just the tip of the iceberg... 


Download Pi Edition now! 


id* 


MfffECRRFt 


PI EDITION 


Tbfl fiyrfvT iteration of hfinacraft. R Fdition in new avnilabfet And fr'n c 
aowr.lt>ad. Wo re adding new features in duo course, but though ycu guys would 
appreciate us getting sonrctiiirg oul to you as soon as possible. 


A1 Requirements 

Vr I Minecraft-Pi requires you to be running Raspbian on 
your Raspberry Pi, so if you’re not already running that, take a 
trip to raspberrypi.org and get it setup. It also requires you have 
X Window loaded too. Assuming you’re at the command prompt, 
you just need to type startx to reach the desktop. 














PROGRAM MINECRAFT-PI 



AA Installation 

\Jfmm Make sure you’re already in your 
home folder and download the Minecraft- 
Pi package with the following commands 
in a terminal window: 

| cd ~ 

wget https : //s3 .amazonaws.com/ 
assets.minecraft.net/ 
pi /mi ne craft-pi-0. 1 . 1 . tar. gz 

To use it we need to decompress it. Copy 
the following into the terminal window: 
tar -zxvf minecraft-pi-0.1.1.tar.gz 
Now you can move into the newly 
decompressed Minecraft-Pi directory 
and try running the game forthef irst time: 
| cd mcpi 
| ./minecraft-pi 

Playing Minecraft-Pi 

Have a look around the game. 
If you’re not familiar with Minecraft, you 
control movement with the mouse and 
the WASD keys. Numbers 1-8 select items 
in your quickbar, the space bar makes you 
jump and Shift makes you walk slowly (so 
you don't fall off edges). ‘E’ will open your 
inventory and double-tapping the space 
bar will also toggle your ability to fly. 


M Configuring the Python API 

To take control of Minecraft with 
the Python API, you next need to copy the 
Python API folder from within the /mcpi 
folder to a new location. In the terminal, 
type the following: 
cp -r “/mcpi/api/python/mcpi 
“/ minecraft 

In this folder, we want to create a 
‘boilerplate’ Python document that 
connects the API to the game. Write the 
following into the terminal: 

cd “/minecraft 
nano minecraft. py 

With nano open, copy the following and 
then save and exit with Ctrl+X, pressing 
Y (for yes), then Enter to return to the 
command prompt: 
from mcpi. minecraft import 
Minecraft 

from mcpi import block 
from mcpi.vec3 import Vec3 
me = Minecraft. create() 
mc.postToChatC'Minecraft API 
Connected") 


/\|J Testing your Python script 

The short script you created 
contains everything you need to get 
started with hacking Minecraft-Pi in the 
Python language. For it to work, you need 
to have the game already running (and 
be playing). To grab control of the mouse 


Full code listing 

# ! /usr/bin/env python 

from mcpi .minecraft import Minecraft 
from mcpi import block 
from mcpi,vec3 import Vec3 
from time import sleep, time 
import random, math 

me - Minecraft. create() # make a connection to the game 
playerPos = me. player. getPosQ 

# function to round players float position to integer position 

def roundVec3(vec3) : 

return Vec3(int(vec3,x) , int(vec3.y), int(vec3.z)) 

# function to quickly calc distance between points 

def distanceBetweenPoints(pointl, point2): 
xd - point2.x - pointl.x 

yd - poinf2,y - pointl.y 

zd = points ,z - point!. z 

return math. sqrt((xd*xd) + (yd*yd) + (zd*zd)) 

def random„block() : # create a block in a random position 
randomBlockPos = roundVec3(playerPos) 
randomBlockPos. x - random. randrange( randomBlockPos. x - 50 p randomBlockPos. x + 50) 
randomBlockPos. y - random. randrange( randomBlockPos. y - 5, randomBlockPos. y + 5) 
randomBlockPos. z = random. randrange( randomBlockPos. z - 50, randomBlockPos. z + 50) 
return randomBlockPos 

def main(); # the main loop of hide & seek 
global lastPlayerPos, playerPos 
seeking = True 
lastPlayerPos - playerPos 

randomBlockPos = random_block() 

me. setBlockfrandomBlockPos , block. DIAMGND_B10CK) 

mc.postToChat( u A diamond has been hidden somewhere nearby!”) 

lastDistanceFromBlock - distanceBetweenPoints(randomBlockPos, lastPlayerPos) 
timeS tart ed - timeQ 
while seeking: 

# Get players position 
playerPos - me. player, getPos() 

# Has the player moved 

if lastPlayerPos ! = playerPos: 

distanceFromBlock = distanceBetweenPoints (randomBlockPos, playerPos) 

if distanceFromBlock < 2: 

#found it! 
seeking ~ False 
else: 

if distanceFromBlock < lastDistanceFromBlock: 

me. postToChat (“Warmer “ + str(int (distanceFromBlock)) + “ blocks away”) 
if distanceFromBlock > lastDistanceFromBlock: 

me, postToChat (“Colder u + str(int (distanceFromBlock)) + “ blocks away”) 

lastDistanceFromBlock = distanceFromBlock 

sleep(2) 

timeTaken - time() - timeStarted 

mc.postToChat( u Well done - “ + str(int(timeTaken)) + “ seconds to find the diamond”) 

if name — “ main__” : 

main() 


Get the 
code: 
bit. ly/ 
1fo7MQ3 



Functional, & 
fun coding 

There’s nothingtoo 
taxing about our 
code. We’ve created 
a couple of simple 
functions (starting 
with def) and used 
if, else and while to 
create the logic. 


while in-game, you can press Tab. Open a 
fresh terminal window, navigate into your 
minecraft folder and start the script with 
the following commands: 
cd -/minecraft 
python minecraft. py 
You'll see a message appear on screen to 
let you know the API connected properly. 
Now we know it works, let’s get coding! 


Hide & Seek 

\/w As you can see from the code above, we’ve created a 
game of Hide & Seek adapted from Martin O’Hanlon’s original 
creation (which you can find on www.stuffaboutcode.com). 
When you Launch the script, you’ll be challenged to find a 
hidden diamond in the fastest time possible. We’ve used it to 
demonstrate some of the more accessible methods available in 
the API. But there’s much more to it than this demonstrates. Stay 
tuned - we’ll be back with more related guides in future issues. 
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Experiment with physical computing by using Scratch to 
interact with buttons and lights on your Pi 


What youH need 

Breadboard 

■ LEDs 

■ Buttons 

■ Resistors 

■ Jumper wires 

■ ScratchGPI03 


Scratch is a very simple visual 
programming language, commonly 
used to teach basic programming 
concepts to learners of any age. In 

this project we’ll learn how to light up 
an LED when a button is pressed in 
Scratch, and then change a character’s 
colour when a physical button is 
pressed. With these techniques 
you can make all manner of fun and 
engaging projects, from musical 
keyboards to controllers for your 
Scratch games and animations. 


Installing the required software 

\/ 1 Log into the Raspbian system with the username Pi and 
the password raspberry. Start the LXDE desktop environment 
using the command startx.Then open LXTerminal and type the 
following commands: 

wget http://liairifraser.co . uk/lud/install_scratchgpio3. sh 
chmod +x install_scratchgpio3.sh 
) sudo bash install_scratchgpio3.sh 

This will create a special version of Scratch on your desktop 
called ScratchGPI03. This is a normal version of Scratch 
with a Python script that handles communications between 
Scratch and the GPIO. ScratchGPIO was created by simplesi 

(cymplecy.wordpress.com). 


k 
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GET INTERACTIVE WITH SCRATCH 



* * * * i 

• * • • i 


Connecting the breadboard 

Power off your Pi and disconnect the power cable. Get 
your breadboard, an LED, a 330-ohm resistor and two GPIO 
cables ready. You’ll want to connect the 3.3V pin (top-right pin, 
closest to the SD card) to one end of the 330-ohm resistor, and 
then connect the positive terminal of the LED (the longer leg is 
positive) to the other end. The resistor is used to limit the amount 
of current that can flow to the LED. 

Then put the negative terminal of the LED into the negative 
rail of the breadboard. Connect one of the GROUND pins (for 
example, the third pin from the right on the bottom row of pins) 
to the negative lane. Now connect the power to your Pi. The LED 
should light up. If it doesn’t, then it’s likely that you’ve got it the 
wrong way round, so disconnect the power, swap the legs around 
and then try again. 

^*5 Switchingthe LED on and off 

At the moment, the LED is connected to a pin that 
constantly provides 3.3V. This isn’t very useful if we want to be able 
to turn itonandoff, so let’s connect it to GPI0 17, which we can turn 
on and off. GPI0 17 is the sixth pin from the right, on the top row of 
pins. Power the Pi back on. We can turn the LED on by exporting 
the GPIO pin, setting it to an output pin and then setting its value 
to 1. Setting the value to 0 turns the LED back off: 
echo 17 > /sys/class/gpio/export 
| echo out > /sys/class/gpio/gpiol7/directlon 
| echo 1 > /sys/class/gpio/gpiol7/value 
echo 0 > /sys/class/gpio/gpiol7/value 


uses pin numbers rather than GPIO numbers to identify pins. 
The top-right pm (the 3.3V we first connected our LED to) is pin 
number 1, the pin underneath that is pin number 2, and soon. 
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fiC Wiring up our push button 

\#%# Power off the Pi again. This circuit is a little bit more 
complicated than the LED one we created previously. The first 
thing we need to do is connect 3.3V (the top-right pin we used to 
test our LED) to the positive rail of the breadboard. Then we need 
to connect a lOKohm resistor to the positive rail, and the other end 
to an empty track onthe breadboard. Then on the same track, add 
a wire that has one end connected toGPI04.This is two pins to the 
right of GPI0 17. Then, on the same track again, connect one pin of 
the push button. Finally, connect the other pin of the push button 
to ground by adding a wire that is connected to the same negative 
rails that ground is connected to. 

When the button is not pressed, GPIO 4 will be receiving 3.3V. 
However, when the button is pressed, the circuit to ground will be 
completed and GPIO 4 will be receiving OV (and have a value of 0), 
because there is much less resistance onthe path to ground. 

We can see this in action by watching the pin’s value and then 
pressingthe button to make it change: 
echo 4 > /sys/class/gpio/export 
| echo in > /sys/class/gpio/gpio4/direction 
watch -n 0.5 cat /sys/class/gpio/gpio4/value 


You’ll 

learn 



1. Simple 
circuits 

WhiLe these are very 
simple circuits, you 7 
get a great feel of 
how the Raspberry 
Pi interfaces with 
basic prototyping 
kit. If you need to buy 
the bits and pieces* 
we recommend you 
checkout: 
shop.pimorom.com 


2. Coding 


nr irii iniPs 

L^l II Ivl IJIwO 

tf you’re new to 
programming, 
Scratch is the 
perfect place to 
learn the same 
programming 
principles employed 
by all programming 
languages. 

3. Physical 
computing 

There’s nothing more 
magical than taking 
code from your 
computer screen 
and turning it into a 
real-life effect. Your 
first project might 
justturnalighton 
and off, but with that 
skill banked, the sky 
is the Limit. 


when 



vet* 


M Controlling the LED from Scratch 

Start the LXDE desktop environment and open 
ScratchGPI03. Go to the control section and create a simple script 
that broadcasts pinllon when Spritel is clicked. Then click the 
sprite. The LED should light up. Then add to the script to wait 1 
second and then broadcast pinlloff. If you click the sprite again, 
the LED will come on for a second and then go off. ScratchGPI03 


pin/ sensor value = H 


broadcast pinllon 




broadcast ptnlloft 


A/ Letthere be light! 

\#0 Boot up the Pi and start ScratchGPI03 as before. Go 
to the control section and add when green flag clicked, then 
attach a forever loop, and inside that an if else statement. Go 
to the operators section and add an if [] = [] operator to the 
if statement. Then go to the sensing section and add a value 
sensor to the left side of the equality statement, and set the 
value to pin7. On the right side of the equality statement, enter 
0. Broadcast pinllon if the sensor value is 0, and broadcast 
pinlloff otherwise. Click the green flag. If you push the button, 
the LED will light up! 
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10 PRACTICAL RASPBERRY PI PROJECTS 



Use Google Coder to turn your Raspberry Pi into a tiny, 
low-powered web server and web host 


What you'll need 


■ Internet connectivity 

■ Web browser 
Google Coder 


pll..' aJ p! I rr f 

stive! 

ab.github.io/ 

coder/ 

r h Pi nberr v 1 


nicoi/teachin 

g html 



1 II MM U VU,«IVl III * 



We’re teaching you howto code in many 
different ways on the Raspberry Pi, so 
it only seems fitting that we look at the 
web too. 

There’s a new way to use the web on 
the Raspberry Pi as well: internet giant 
Google has recently released Coder 
specifically for the tiny computer. It’s a 
Raspbian-based image that turns your Pi 
into a web server and web development 
kit. Accessible easily over a local network 
and with support for jQuery out of the 
box, it’s an easy and great way to further 
your web developmentskills. 


Get Google Coder 

■ Head to the Google Coder website, and download the 
compressed version of the image. Unpack it wherever you wish, 
and install it using dd, like any other Raspberry Pi image: 

$ dd if=[path to]/raspi.img of=/dev/[path to SD 
card] bs~!M 
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BUILD A RASPBERRY PI WEB SERVER 



Plug in your Pi 

For this tutorial, you’ll only need to connect a network 
cable into the Pi. ::> op in your newly written SD card, plug in the 
power and wait a few moments. If you’ve got a display plugged in 
anyway, you’ll notice a Raspbian startup sequence leading to the 
command-line login screen. 

Connect to Coder 

\J%$ Open up the browser on your main system, and go to 
http://coder.local. You may have to manually accept the licence. 
It will ask you to set up your password, and then you’ll be in and 
ready to code. 



M Language of the web 

Now it’s time to create your own app or website. Click 
on the ’+’ box next to the examples, give your app a name and 
then click Create, You’ll be taken to the HTML section of the app. 
Change the Hello World lines to: 

<hl>This is a HTML header</hl> 

<p>This is a new block of default text</p> 



Styled to impress 

V/wJ Click on the CSS tab. This changes the look and style of 
the webpage without having to make the changes each time in the 
main code. You can change the background colour and font with: 

body { 

background-color: #000000; 
color: #ffffff; 

l) 


Full code listing 


Some simple HTML 
code that can 
point us to some 
important websites. 
The h2 tag is used 
to display the time 
thanks to Java 


HTML 

<hl>Welcome to the internet... </hl> 

<h2></h2> 

<p><a href="http;//www.linuxuser.co.uk">Linux 
Developer</p> 

<pXa href=”http://www. reddit.com/">Reddit</p> 
<pxa href="http://www.linuxfoundation.org/">The 
Linux Foundation</p> 

<p><a href=”http://www.fsf.org/”>Free Software 
Foundation</p> 


User & 


Java 


We’re calling the 
current time using 
jGuery in theJS 
tab so that we can 
ultimately display it 
on the webpage 

We’re going to 
display the time asa 
12-hour dock in the 
first if statement, 
and use AM and PM 
to differentiate 
the time 


var 




We make the 


minutes readable 

I 

by adding a 0 if 


it’s below 1 0, then 


concatenate all 


the variables and 


assign to the tag h2 



a 


d - new Date; 
var hours = d*getHours(); 
var rnins - d<getMinute$(); 
if (hours > 12) { 

var hour = (hours - 12); 
var ampm = “PM"; 

} 

else { 

var hour = hours; 
var ampm = “AM"; 

} 

if (hours == 12) { 
var ampm = “PM"; 

> 

if (mins > 9){ 

var min = mins; 

> 

else { 

var min = “0" + mins; 

i 

var time = “The time is “ + hour + + min 

“ + ampm; 

$(“h2”).html(time); 


Get the 
code: 
bit.ly/ 
1Vz5cYv 




1 till rr y_hurr^ i 

X i I 

X todcr.kitd! 




My homepage 


HTML CSS JS NODE 



$(doCtl"C' t ),T6idy( funttlonO { 

( ' ),LlUk( f urKtAunO { 

3lert( 

) 


This is a h 

This is 9 new bloc 




); 




Tht p.icjr At !h tt p i : '.'c od pnlo-c a I 


YUu iB'-iLf.yd Ihv 




£ Querying your Java 

The third tab allows you to edit the jQuery, making 
the site more interactive. We can make it create a message on 
click with: 

S(document).click(function() { 

alertf'You clicked the website!'); 

I > 

I); 
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10 PRACTICAL RASPBERRY PI PROJECTS 




What you'll need 


■ Internet connectivity 

■ Latest version of Raspbian 



Twitter is a useful way of sharing 
information with the world and it’s 
our favourite method of giving our 
views quickly and conveniently. Many 
millions of people use the microblogging 
platform from their computers, mobile 
devices and possibly even have it on 
theirtelevisions. 

You don’t need to keep pressing that 
retweet button, though. With a sprinkling 
of Python, you can have your Raspberry 
Pi do it for you. Here’s how to create your 
own Twitter bot... 


A*| Installing the required software 

\# I Log into the Raspbian system with the username Pi and 
the password raspberry. Get the Latest package lists using 
the command sudo apt-get update. Then install the Python 
Package installer using sudo apt-get install python-pip. 
Once you’ve done that, run sudo pip install twython to install 
the Twitter library well be using. 


02 


Registering with Twitter 

We need to authenticate with Twitter using OAuth. 
Before this, you need to go to https://dev.twitter.com/apps and 
sign in with the account you’d like your Pi to tweet from. Click 
the ’Create a new application’ button. We called our application 


■ Save your 
mouse button 
by creating an 
automated 
retweeter 
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CODE YOUR OWN TWITTER BOT 


‘LUD Pi Bot’, gave it the same description and set the Website to 
http://www.linuxuser.co.uk/. The Callback URL is unnecessary. 
You’ll have to agree with the developer rules and then click the 
Create button. 

Creating an access token 

\J%* Go to the Settings tab and change the Access type 
from ‘Read only' to ‘Read and Write". Then click the ‘Update 
this Twitter application’s settings’ button. The next step is to 
create an access token. To do that, click the ‘Create my access 
token’ button. If you refresh the details page, you should have 
a consumer key, a consumer secret and access token, plus an 
access token secret. This is everything we need to authenticate 
with Twitter. 


r If the tweet’s time is newer than 
the time the function was Last 
_ called, we retweet it 

Retweeting a user 

V/w The first thing we need to do is get a list of the user’s 
latest tweets. We then loop through each tweet and get its 
creation time as a string, which is then converted to a datetime 
object. We then check that the tweet's time is newer than the 
time the function was last called - and if so, ref weetthe tweet. 


Authenticating with Twitter 

We’re going to create our bot as a class, where we 
authenticate with Twitter in the constructor. We take the tokens 
from the previous steps as parameters and use them to create 
an instance of the Twython API. We also have a variable, last_ran, 
which is set to the current time. This is used to check if there are 
new tweets later on. 


The main section 

The main section is straightforward. We create an 
instance of the bot class using our tokens, and then go into an 
infinite loop. In this loop, we check for any new retweets from 
the users we are monitoring (we could run the retweet task with 
different users), then update the time everything was last run, 
and sleep for five minutes. 




Full code listing 



#! /usr/bin/env python2 

# A Twitter Bot for the Raspberry Pi that retweets any 
content from 

# @LinuxUserMag, Written by Liam Fraser for a Linux User & 
Developer article, 

import sys 
import time 

from datetime import datetime 
from twython import Twython 

class bot: 

def init (self, c_key r c^secret , a^token, a__token_ «-■ 

secret) : 

# Create a Twython API. instance 

self.api = Twython (c_key t c„secret, a_token, ^ 
a_token_secret) 

# Make sure we are authenticated correctly 
try: 

self.api . verify_credentials() 

except: 

sys. ex it ("Authentication Failed") 
self ,last_ran = datetime, now() 

0staticmethod 

def timestr_t 0 _datetime(tifflestr) : 

# Convert a string like Sat Nov 09 09:29:55 +0000 

# 2013 to a datetime object. Get rid of the timezone 

# and make the year the current one 

timestr = "{0} {1}" , format(timestr[; 19] , datetime, «- J 
now() . year) 

# We now have Sat Nov 09 09:29:55 2013 

return datetime . strptime(timestr , *%a %b %d %H:%M: ^ 

XS %Y 5 ) 

def retweet_task(self , screeo_name) : 

# Retweets any tweets we've not seen 


# from a user 

print "Checking for new tweets from 0(0}", 

format (screen_name) 

# Get a list of the users latest tweets 

timeline - self ,api .get,user_timeline - 
(screen_name - screen_name) 

# Loop through each tweet and check if it was 

# posted since we were last called 
for t in timeline: 

tweet m tirne - bot . timestr = to_datetime 
(t[ ‘ created^at * ]) 

if tweet_time > self . last_ran: 

print "Retweeting {0}" . format(t[/ id ’ ]) 
self .api . retweetfid = t[‘id']) 

if name_ == " main 

# The consumer keys can be found on your application’s 

# Details page located at https : //dev, twitter . com/ 

# apps(under "OAuth settings") 
c_key=”” 

c„secret="" 

# The access tokens can be found on your applications 's 

# Details page located at https : //dev, twitter . com/apps 

# (located under "Your access token") 

a^token-"” 

a_token_secret=”” 

# Create an instance of the bot class 

twitter = bot(c_key, c_secret r a^token, a_token_secret) 

# Retweet anything new by SLinuxUserMag every 5 minutes 
while True: 

# Update the time after each retweet^task so we’re 

# only retweeting new stuff 

twitter, retweet_task("LinuxUserMag’') 
twitter . Iast_ran - datetime , now() 
time. sleep(5 * 60) 
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10 PRACTICAL RASPBERRY PI PROJECTS 


he Arduino is better at dealing with 
things like servos and analog input 




What you'll need 

■ Arduino Uno 

■ Internet connectivity 

■ Nanpy 


You might be wondering why you might want to attach an 
Arduino to your Raspberry Pi. While there are lots of reasons, 
probably the most poignant is the extra six PWM-capable 
pins and another six analogue pins that a standard Arduino 
Uno offers. 

You see, while the Raspberry Pi has an excellent array of 
pins and capabilities, it can’t do analogue and it can’t do real- 
time processing outof the box. With an Arduino, additions like 
servos, potentiometers and a whole array of analog sensors 
are trivially easy to trigger and control. 

The best part is that you don’t even have to program in 
Arduino’s quasi-C++ language. All you need is a standard 
USB connection between your Raspberry Pi and Arduino and 
a small Python package called Nanpy. Here's how it’s done... 


flfl Grab an Arduino 

\J I Before you can do anything, you 
need an Arduino. We recommend the 
Uno, since it’s the default choice with the 
best balance of features, convenience 
and affordability. Since you’ll want to put 
it to use straight away, we recommend 
investing in a ‘starter kit’ that includes 
LEDs, servos and all that fun stuff. 


A A Satisfying dependencies 

We’re assuming you’re using 
Raspbian (recommended), so open 
your terminal because we need to get 











PROGRAM YOUR ARDUINO WITH RASPBERRY PI 


The best part is that you 
don’t even have to program in 
Arduino’squasi-C++ Language 


setuptools so we can install Nanpy. At the terminal, type: 

| wget https://bitbucket.org/pypa/setuptools/raw/ 
bootstrap/ez_setup. py 
python ez_ setup. py user 

Once this is complete, you'll be able to use the easyjnstall 
command to install pyserial... 


Full code listing 

# Like all good hardware-based 'Hello, World' applications, we’ll start 

# by making the light on the Arduino board flicker off and on. 

from nanpy import Arduino 
from time import sleep 


Final preparations 

r Since the communication between the Arduino and 
Raspberry Pi will happen over the USB serial connection, we 
need to getthe Python-serial library. At the terminal, type: 

| easy_install pyserial 

We also need to install the Arduino software so the Pi knows how 
to deal with the device when it's plugged in. In the terminal, type: 

| sudo apt-get update 
sudo apt-get install arduino 


Arduino, pinMode(13, Arduino. OUTPUT) 
for i in range(10): 

Arduino. digitalWrite (13, Arduino. HIGH) 
sleep(2) 

Arduino. digitalWrite(13, Arduino. LOW) 
sleep(2) 

# This will make the light controlled by pin 13 on the Arduino 

# turn on and off every two seconds ten times. 

# You can also assign pins a name, to make your code more readable. 


f\A Install Nanpy 

%/""l There are only two steps remaining in the configuration. 
First, we need to get the Nanpy package downloaded and 
installed on the Pi. Our preferred way is to clone it with Git. 
Navigate to your home folder in the terminal (cd ~) and do the 
following in the terminal, one afterthe other: 
easy_install nanpy 
| sudo apt-get install git 
j git clone https://github.com/nanpy/nanpy.git 

I g® Configure your Arduino Uno 

Why have we cloned the original Git repository? 
Nanpy relies on an update to the Arduino firmware to function 
correctly, so you’ll need to access the firmware folder from the 
nanpy project directory to do it. Before typing the following into 
the terminal, plug your Arduino Uno into a spare port on the 
Raspberry Pi. Beware: the following takes so me time! 

| cd nanpy/firmware 
export BQARD^uno 
make 

make upload 


Testing Arduino with your Pi 

VH# With the installation finally complete, we can test the 
setup to make sure it works properly. Before we do a proper 
‘Hello World’ application in the code segment to the right, let’s 
first ensure Nanpy is properly installed and the connection 
between Pi and Arduino is working. From your home folder (cd 
~), type the following into the term inal: 
nano nanpyjtest.py 
In the nano editor, simply write: 

, from nanpy imort Arduino 

Now press Ctrl+X, Y, then Enter to save your new file. 

Finally, in the terminal, type: 

Python nanpy_test . py 

If you don’t see an error, then everything should be working fine. 
Now you can play with the code across the page to start learning 
your way around Nanpy. 


light = 13 

Arduino. pinMode(light, Arduino. OUTPUT) 

# You can also assign multiple pins at the same time: 

red_pin = 3 
green_pin - 5 
blue_pin = 9 

for pins in (red_pin, green_pin, blue_pin): 

Arduino. pinMode (pi ns, Arduino. OUTPUT) 

# if you’ve got an LED screen for your RasPi you’ll probably 

# find it works out of the box with Nanpy. Just make sure you 

# assign the right pin numbers for your screen: 

from nanpy import (Arduino, Led) 

screen = Lcd([7, 8, 9, 10, 11, 12], [16, 2]) 
screen. printString(“Hello, World!”) 


# If you’re using potentiometers, buttons or analog sensors, 

# you’ll need to assign them as inputs 

knob = 0 

Arduino. pi nMode (knob, Arduino. INPUT) 


value = Arduino. analogRead(knob) 
for i in range(10): 

print “The value of the knob is:”, knob 
sleep(l) 


You’ll 

learn 



# Sometimes you want to delay what the arduino does. 

# This can help you get consistent, solid readings 

def get_value(): 

value - Arduino, analogRead(knob) 

Arduino + delay(100) 
return value 

for i in range(100): 

print “The value is:”, get_vaiue() 


1. Playing to 
strengths 

While the RasPi is 
much more powerful 
than Arduino, the 
latter has the u pper 
hand when it comes 
to interfacing with 
the real worLd. 
Leverage both their 
strengths to make 
better projects. 
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10 PRACTICAL RASPBERRY PI PROJECTS 



WhatyouH need 

Arduino Uno 

■ Breadboard 

Set of prototyping cables 
RGB LED (cathode) 

■ 3x potentiometers 

■ 3x 330 Ohm resisters 


In the previous project we showed you how you can 
use an Arduino microcontroller to help the Raspberry 
Pi become proficient in new skills that can drastically 
increase the reach of your projects. With the aid of the 

extra 12 pins capable of PWM and analogue input, you 
could easily add multiple servos, analogue sensors and 
even add input devices Like joysticks. 

In this project we’re going to demonstrate this by creating 
a three-colour lamp that employs three potentiometers 
(twisty knobs) to control each of the three colours in an RGB 
LED light. With it you can make most of the colours of the 
rainbow. As you’d expect, this would be much more difficult 
using just a Raspberry Pi alone. 


Program with Arduino 

V You'll need to have followed the 
steps from with the previous project to 
correctly configure your Raspberry Pi and 
Arduino Uno. You’ll also need to ensure 
you’ve got all the components from the 
list to the left. The resistors should be 
330-ohm ideally, but can be of a higher 
resistance if that’s all you have available. 
Arduinos can be bought as part of 
‘starter packs' that include exactly these 
kinds of components, but a quick visit to 
www.cpc.co.uk should fill any holes. 


■ This is a great prototype for an attractive 
RGB lamp - a great night light or mood piece 






CREATE A RASPBERRY PI THREE-COLOUR LAMP 



Populate the breadboard 

V/fc. The circuit forthis project might look a little complicated 
at first glance, but actually there’s very little going on. As you’d 
expect, we want to control the LED light using PWM-enabled 
pins (to have fine-grained controL of the brightness) and the 
potentiometers (pots) are being read by the analogue pins. 

Connect the Arduino and Raspberry Pi 

Ik w \ . Assuming you don’t plan to write up the code 
immediately yourself, you can grab it from the disc or from the 
website and drop it in your home folder. With the USB cable from 
the Arduino plugged into the Raspberry Pi, you simpLy need to 
run the code with the following: 

| python RGELMixer.py 

Adjust the pots for the corresponding colour of the LED and 

Full code listing 

#!/usr/bin/env python 

from nanpy import Arduino 
from time import sleep 


# set LED pin numbers - these go to the 

# Digital pins of your Arduino 

redPin = 3 
greenPin = 6 
bluePin = 9 


# set pot pin numbers - these go to the 

# (A) n a log pins of your Arduino 

pot_r_Pin - 0 
pot_g_Pin = 3 
pot_b_Pin = 5 

#set three coloured pins as outputs 

for pins in (redPin, greenPin, bluePin); 

Arduino. pi nMode(pins, Arduino, OUTPUT) 

# set pot pins as inputs 

for pins in (pot_r_Pin, pot.g.Pin, pot.b.Pin): 

Arduino. pi nMode(pins, Arduino. INPUT) 

# prints values to the terminal when True 
debug - False 

del get.potsQ: 

N H tl 

Grab a reading from each of the pot pins and 
send it to a tuple to be read by the colour mi 

tJ II IF 

r - Arduino. analogRead(pot_r_Pin) / 4 
Arduino. delay(l) 

g = Arduino. analogRead(pot_g_Pin) / 4 
Arduino. delay(l) 

b = Arduino. analogRead(pot_b_Pin) / 4 
Arduino. delay(l) 

return r, g r b 


the colours should change. If the pots are adjusting the wrong 
colours, just swap them over. You could use a table-tennis bailor 
plastic mugto diffuse the light to great effect. 

M Setting up the pins 

As we demonstrated in the last project, it’s easy to name 
and set the Arduino pins with Nanpy - in our code we’ve used 
two simple for loops to do the job. The debug value below simple 
prints the values of each pot to the terminal - very useful for 
debugging or getting a better handle on the code. 

Functional operation 

There are only really three main functions here, written 
with self-explanatory names. Firstly, get_pots() reads in the 
analogue pin value associated with each pot-pin and returns 
a tuple of the value for red, green and blue respectively. This is 
used by the colour_mixing() function to assign values to each of 
the associated PWM pi ns to change the colours of the LED. 

Keepingthings running 

VHLr The main() function is where the other functions are set 
to work. Inside the function, we’re asking Python to mix the colours 
(and print the values if debug is True) forever, except if we press 
Ctrl+C - initiating the keyboard interrupt. Since we want to clean 
up after ourselves, this action with trigger close_pins() - this turns 
offthe pins attached to the LED, ready to be used nexttime. 


You’ll 

learn... 



1. Analogue 
inputs 

It is possible to 
utilise analogue 
inputs with the 
Raspberry Pi using 
an analogue-to- 
digital converter 
(ADC) chip like 
the MPC3008, 
but they’re much 
easier to handle 
with an Arduino 
using Nanpy, 

2. Comment 
your code! 

WeVe tried to adhere 
to the best practices 
for commenting 
Python code in this 
project, We’re using 
^'comments before 
assignments and 
quoted comments 
with in functions. 


xer 


def colour_mixing(): 

IF IF PI 

Call get_pots() and set 
the colour pins accordingly 

ft pr f j 

r, g, b = get^pof sQ 
Arduino.analogWriteCredPin, r) 

Arduino.analogWrite (greenPin, g) 

Arduino. analogWrite(bluePin T b) 

Arduino. delay(l) 

def close_pins(): 

IF FF II 

Close pins to quit cleanly (doesn't work with a 'for 
loop' despite the pins happily initialising that way!) 

IF IF FF 

Arduino. digitalWrite (redPin, Arduino. LOW) 

Arduino, digitalWrite (greenPin .Arduino. LOW) 

Arduino. digitalWrite(bluePin,Arduino. LOW) 

def main(): 

IF If PI 

Mix the colours using three pots. 

Ctrl+C cleans up the pins and exits. 

PI PP PI 

try: 

print "Adjust the pots to change the colours" 
while True: 

colour. mixingO 
sleep(0.2) 
if debug: 

print "Red: {:d} j Green: 

{:d} | Blue: {: d} . format(r, g, b) 
except Keyboardlnterrupt: 
elose.pinsQ 
print "\nPins closed" 

if „name__ == J main 1 : 

mainQ 


Get the 
code: 
bit.ly/ 
1Vz5sGL 



10 PRACTICAL RASPBERRY PI PROJECTS 



We update the retro classic Pong for the Linux generation 
with a new library called SimpleGUITk 


What youl need 

■ Latest version of Raspbian 

www.raspberrvpi.orR/downloads 

J 1 O 

■ Pillow 


SimpleGUITk 

https://eithub.com/dholm 



The Raspberry Pi is a fantastic way 
to start learning how to code. One 

area that can be very rewarding for 
amateur coders is game programming, 
allowing for a more interactive 
result and a greater sense of 
accomplishment. Game programming 
can also teach improvisation and 
advanced mathematics skills for 
code. We’ll be using the fantastic 
SimpleGUITk module in Python, a 
very straightforward way of creating 
graphical interfaces based on Tkinter. 


Python module preparation 

Vr R Head to the websites we’ve listed in ‘What you'll need' and 
download a zip of the source files from the GitHub pages. Update 
your Raspbian packages and then install the following: 

$ sudo apt-get install python-dev python-setuptools 
tk8.5-dev tcl8.5-dev 


# a Install the modules 

Open the terminal and use cd to move to the extracted 
Pillow folder. Once there, type: 

$ sudo python setup. py install 
Once that’s complete, move to the simpleguitk folder and use the 
same command to install that as well. 


■ Rob got off to a good start, but it was 
all downhill from there. . , 




MAKE A GAME WITH PYTHON 



Write your code 

Launch IDLE 2, rather than IDLE 3, and open a new 
window. Use the code listing to create our game ‘Tux for Two’. Be 
carefuL to follow along with the code to make sure you know what 
you’re doing. This way, you can make your own changes to the 
game rules if you wish. 

Set upthe game 

There’s nothing too groundbreaking to start the code: 
Tux’s and the paddles’ initial positions are set, along with the 
initial speed and direction of Tux. These are also used when 
a point is won and the playing field is reset. The direction and 
speed is set to random for each spawn. 


TheSimpleGUIcode 

The important parts in the draw function are the 
draw_line, drawjmage and draw_text functions. These are 
specifically from SimpleGUI, and allow you to easily put these 
objects on the screen with a position, size and colour. You need to 
tie them to an object, though - in this case, canvas. 

SimpleGUI setup code 

The Last parts are purely for the interface. We tell the 
code what to do when a key is depressed and then released, and 
give it a frame to work in. The frame is then told what functions 
handle the graphics, key functions etc. FinalLy, we give it 
frame.startQ so it starts. 






Full code listing 

import simpleguitk as simplegui 
import random 

w - 600 
h = 400 
tux_r - 20 
padjw- S 
pad_h - 80 

def tux_spawn(right): 

global tux^pos, tux^vel 
tux_po$ - [0,0] 
tux^vel = [0,0] 
tux_pos[0] = w/2 
tux_pos[l] = h/2 
if right: 

tux_vei[0] = random. randrange(2, 4) 

else: 

tux_vel[0] - -random, randrange(2, 4) 
tux_vel[l] = -random. randrangeQ, 3) 

def start(): 

global paddIel„pos, paddle2_pos, paddlel.vel, paddle2_vel 

global score!, score2 

tux_spawn (random. choice( [True, False])) 

scorel, score2 = 0,0 

paddlel_vel, paddle2_vel = 0,0 

paddlel_pos, paddle2_pos = h/2, h/2 

def draw(eanvas): 

global score!, score2, paddlel_pos, paddle2_pos, ■ 
tux_pos, tux_vel 

if paddlel_pos > (h - (pad_h/2)): 
paddlel_pos = (h - (pad_h/2)) 
elif paddlel^pos < (pad„h/2): 
paddlel^pos - (pad_h/2) 

else: 

paddlel_pos += paddlel_vel 
if paddle2_pos > (h - (pad_h/2)): 
paddle2_pos = (h - (pad_h/2)) 
elif paddle2„pos < (pad_h/2): 
paddle2_pos = (pad_h/2) 
else: 

paddle2_pos += paddle2_vel 
canvas. draw_line([w / 2, 0],[w / 2, h], 4, “Green”) 
canvas. draw_line([(pad_w/2), paddlel_pos + (pad_h/2)], «-* 
[(pad_w/2), paddlel_pos - (pad_h/2)], pad_w, “Green”) 

canvas. draw_line([w - (pad_w/2) T paddle2_pos + (pad_h/2)], + 
[w - (pad_w/2), paddle2_pos - (pad_h/2)], pad_w, “Green”) 
tux_pos[0] += fuxjvel[0] 
tux_pos[l] += tux_vel[l] 

if tux_pos[l] <~ tux_r or tux_pos[l] >~ h - tux„r: 
tux_vel[l] - -tux_vel[l]*l.l 
if tux_pos[0] <= pad_w + tux_r: 


if (paddlel_pos+(pad_h/2)) >= tux_pos[l] >- (paddlel 
pos-(pad_h/2)): 

tux_vel[0] = -tux_vel[0]*l.l 
tux_vel[l] *= l.l 

else: 

scoreZ +- 1 
tux_spawn(True) 

elif tux_pos[0] >= w - pad_w - tux_r: 

if (paddle2_pos+(pad_h/2)) >- tux_pos[l] >= 1 

(paddle2_pos-(pad_h/2)): 

tux_vel[0] = -tux_vel[0] 
tux_vel[l] *= LI 
else: 

s corel += 1 
tux_spawn (False) 

canvas. draw_image(tux, (265 / 2, 314 / 2), (265, 314), — J 
lux_pos, (45, 45)) 

canvas. draw_text(str(scorel), [150, 100], 30, “Green”) 
canvas.draw„fext(str(score2), [450, 100], 30, “Green”) 

def keydown(key); 

global paddlel^vel, paddle2_vel 
acc = 3 

if key == simplegui. KEY_MAP[“w”]: 
paddlel_vel -= acc 
elif key -- simplegui. KEY_MAP[“s”]: 
paddlel_vel += acc 
elif key==-simplegui, KEY_MAP[“down”] : 
paddle2_vel += acc 
elif key“simplegui.KEY_MAP[“up”]: 
paddle2_vel -= acc 

def keyup(key): 

global paddlel_vel, paddle2_vel 
acc = 0 

if key == simplegui. KEY_MAP[“w”]: 
paddlel_vel = acc 

elif key == simplegui. KEY_MAP[“s”]: 
paddlel_vel - acc 

elif key--simplegui.KEY_MAP[“down”]: 
paddle2_vel = acc 
elif key“simplegui.KEY_MAP[“up M ]: 
paddle2_vel = acc 

frame - simplegui + create_frame(“Tux for Two”, w, h) 
frame, set_draw_handler(draw) 
frame, set _keydown_handler(keydown) 
frame. set _keyup_handler (key up) 

tux ~ simplegui. load_ j image( i http://upload. wikimedia.org/ ‘ ■ 
wikipedia/commons/a/af/Tux.png 1 ) 

start() 
frame. start() 


Get the 
code: 
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\ 10 PRACTICAL RASPBERRY PI PROJECTS 




Fancy yourself as the next Nick Park? Set up this DIY stop- 
motion studio and see what you can do 


Whatyoul need 

■ Latest version of Raspbian 

■ picamera Python module 


■ RasPi camera module 

■ Pygame 



: !-Mation is available on GitHub via 

https://github.com/russb78/pi-mation 


The Raspberry Pi camera module 
opens the door for your Pi projects to 
incorporate aspects of photography 
and movie making. We’re combining 
both here to create a fully featured stop- 
motion animation application, Pi-Mation, 
which makes it incredibly easy to create 
impressive HD animations. 

We’ve written this project with 
Python and it relies on two libraries 
that you will need to install. Picamera 
(picamera.readthedocs.org) is a pure 
Python interface to the Raspberry 
Pi camera module and is a must for 
all camera module owners. Pygame 
(www.pygame.org), which ensures our 
images can be displayed on demand. 


m Set up the camera module 

First things first, you need to make sure your Raspberry 
i is up to date. In the terminal, type: 
sudo apt-get update && sudo apt-get upgrade 
Next we needto update the Pi’s firmare and ensurecamera 
module isactivated. Bear in mind thatthistakes sometime, 
sudo rpi-update 
sudo raspi-config 


Install other dependencies 

UiL Next we’ll make sure Pygame and picamera are installed 

sudo apt-get install python-setuptools 
easy_install -user picamera 
Finally, to install Pygame and the video apps, type: 
sudo apt-get install python-pygame 
sudo apt-get install libav-tools && sudo - 1 
apt-get install omxplayer 







RASPBERRY PI STOP MOTION ANIMATION 


Final setup 

We’re going to install Pi-Mation 
with Git, so let's make sure it’s installed: 

| sudo apt-get install git 
With a terminal open, navigate to your 
home directory (with cd ~) and type: 
git clone https://github.com/ « 
russb78/pi-mation . git 
If you play with the code and break it, you 
can revert it back to its original state with: 
git checkout pi-mation.py 


Running and testing 
Pi-Mation 

Now navigate into the pi-mation folder 
and run the application with: 

| python pi-mation.py 
Pressingthe space bar calls take_pic() 
from the main() loop, which saves an 
image and creates a preview that’s loaded 
byupdate_display().TheTab button is 
coded to toggle between two states by 
asking two variables to switch values. 




f Getting animated 

The main() loop checks for keyboard events before 
updating the screen around 30 times per second. Since the 
camera's live preview is working independently of that loop, 
update_display() only needs to worry about updatingthe 
preview image (prev_pic) Since take_pic() addsto pics_taken, 
only the very latest picture is shown. The animate() function is 
essentially a microcosm of update_display(). When the P key is 
pressed, the live preview is suspended and for all of the pictures 
taken (pics_taken), each one will be ‘blitted’ (updated) on the 
main window. 


Full code listing 

import pygame, picamera, os, sys 
pics_taken - 0 

current_alpha r next^alpha - 128 , 255 
fps = 5 

pygame. init() 

res - pygame. display, list_modes() # return the best resolution - ' 
for your monitor 
width, height - res[0] 

print "'Reported resolution is:", width, "Y' f height 
start_pic - pygame. image. load(os. path, join^data', 
"start_screen.jpg')) 

start_pic_fix = pygame, transform, $caie(start_pic, (width, height)) 

screen - pygame. display, set jTiode([width f height]) 

pygame.display.toggle_fullscreen() 

pygame. mouse. $et_visible = False 

play_clock - pygame. time. Clock() 

camera = picamera.PiCameraQ 

camera. resolution = (width, height) 

def take_pic(): 

global pics_taken, prev_pic 
pics = taken += 1 

camera. capture(os. path .join( pics', image. + 
str(pics_taken) + '.jpg'), use_video_port - True) 

prev^pic - pygame, image, Ioad(os. path, join( "pics', ' image J + 
str(pics_taken) + ',jpg')) 

def delete_pic(): 

global pics.taken, prev.pic 
if pics^taken >= 1: 
pics^taken -= 1 

prev_pic = pygame, image, load (os* path, joio( 'pics 1 , 

J image_' + str(pics_taken) + fjpg')) 

def animate(): 

camera . stop_preview() 

for pic in range (1, pics^taken): 

anim - pygame, image ,load(os, path, join( J pics', 'image.' + - 
st r (pic) + ’.jpg')) 

screen. blit(anim, (0, 0)) 
pi ay _c lo c k . t i ck (f ps) 
pygame. display. flipQ 
play„clock.tick(fps) 
camera. start.previewO 

def update_display(): 
screen. fill((0, 0,0)) 
if pics.taken > 0: 

screen, blit(prev.pic, (0, 0)) 
play_ciock,tick(30) 
pygame, display, fiipQ 

def make_movie(): 

camera. stop_preview() 
pygame. quit() 


print "XnQuitting Pi-Mation to transcode your video." 
os.system("avconv -r " + str(fps) + " -i 1 + str((os. path. 
join('pics\ 'image_%d.jpg'))) + ' -vcodec libx264 video. mp4 1 ) 
sys,exit(0) 

def change.alphaQ: 

global current_alpha, next_alpha 
camera . stop_preview () 

current_alpha, next.alpha = next_alpha, current_alpha 
return next_alpha 


def quit_app(): 
camera. eloseQ 
pygame. quit() 

print "'You've taken", pics.taken, " pictures. Don't 
forget to back them up!" 
sys,exit(0) 


def intro_screen(): 
intro = True 
while intro: 

for event in pygame. event. get (): 

if event. type == pygame. KEYDOWN: 
if event, key -- pygame, K_ESCAPE: 
quit_app() 

elif event, key == pygame. K_F1: 
camera . start_preview() 
intro = False 

screen . blit(start_pic_f ix, (0, 0)) 
pygame . display, update() 

def main(): 

intro_screen() 
while True: 



for event in pygame. event. get (): 

if event, type -- pygame. KEYDOWN: 

if event. key == pygame.K_ESCAPE: 
quit_app() 

elif event, key == pygame. KJ5PACE: 
take_pic() 

elif event. key == pygame. KJ3ACKSPACE: 
delete_pic() 

elif event, key -- pygame. K_RETURN: 
make_movie() 

elif event, key == pygame. K_TAB: 

camera. preview_alpha = change _alpha() 
camera . star t_preview() 

elif event. key == pygame. K_F1: 
camera. stop_preview() 
intro,screen() 

elif event, key =- pygame. K_p: 
if pics_taken > 1: 
animate() 


update„display() 


if name == r main 

mainQ 
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Hardware 

32 Make a Pi 2 desktop PC 

Use your Pi as a replacement PC 

36 How I made: PiKon 

Check out this 3D-printed telescope 

38 Build a RasPi-controlled car 

Take control of a remote-controlled car 

44 How I made: Robot arm 

Get to grips with a Pi-powered robot arm 

46 Make a Raspberry Pi HTPC 

■ inally create a more powerful machine 

48 Make a tweeting wireless 
flood sensor 

Flood-proof your basement 






Constructs 


Check out a crazy 
robot arm 


Read up on this 
3D-printed telescope 


Power up a 
portable tank 


50 Build a Raspberry r— 

Pi-powered Bigtrak - 

Control your own all-terrain vehicle 

S 

54 How I made: PiPanther 

Battle your friends in augmented reality 

56 Make a digital 
photo frame 

Turn your Pi into a beautiful photo frame 

60 How I made: Pi Glass 

Watch these coders hack video goggles 

62 Build a Raspberry Pi 
Minecraft console 

Create a fully functional games console 

68 How I made: Bullet Pi 

What happens when you link 48 Pis together? 


DIY augmented 
reality glasses 


Display your 
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HARDWARE 



Use your Raspberry Pi as a desktop replacement PC thanks to the 
increased power of the Raspberry Pi 2 


The Raspberry Pi 2’s increased power over its predecessor 
is well-documented by now. More CPU cores and more RAM 
making it six times faster is an impressive number, and you 
can see the actual changes that it makes to the experience. 

This power actually enables you to conduct a very simple 
project that was just out of reach for the original Raspberry Pi: 
a Raspberry Pi desktop PC. 

All the components for it were available, but the Pi was just 
a little too slow to properly give a fluid desktop experience. 
Now with the improved resources, many of the restrictions 
are gone - enough of them to be able to build a Pi desktop. So 
grab a Pi 2 and well get started. 


GetRaspbian 

I We will be using Raspbian for our desktop Pi. Not only is 
it simple to obtain and easy to use, but it is supported by the Pi 
Foundation and community, which means it's going to be the 
most fLexible operating system with the most choices for a 
desktop. Download itfrom: www.raspberrypi.org/downloads. 
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What you'll need 


Raspberry Pi 2 
Raspbian 

raspberrypi.org/downloads 

Keyboard 

Mouse 

Wireless dongle 
Monitor 








MAKE A PI 2 DESKTOP PC 



Install Raspbian 

’ . Once Raspbian is downloaded, you can install it to your 
SD card. Put the micro SD into an SD card reader and connect it 
to your main system (a PC or laptop). Open up the terminal, cd to 
the location of the image and use: 


| $ sudo dd bs=lM if=raspbian.img of=/dev/[ location of 
SD card] 


AO Setup options 

On first boot there will be some setup stuff that it is 
necessary you go through. The most important things to do for 
this desktop are to first hit ‘Enable Boot to Desktop’ and then to 
extend the installation to fill the entire SD card. After you have 
done that, do anything else that you want to do in these menus 
and then reboot before moving on to the next step. 

M First boot 

You will boot into a fresh version of Raspbian with the 
newer interface and default apps available to use. From here 
you can start using it as normal if you wish, but it is worth noting 
that there are a few extra things that you should do to make it 
truly desktop worthy. 


AP Software updates 

\/%J Our first step is to perform an upgrade on the system to 
make sure it's all up to date and working properly. To do this, open 
up the terminal from the menus and use: 

| $ sudo apt-get update 


...to refresh the software list, followed by the next command to 
then upgrade to newer software: 

| $ sudo apt-get upgrade 



Above Make sure 
you set the Pi to 
boot straight to the 
desktop, like your 
main computer 


Firmware upgrade 

%/W While we’re updating, it’s a good idea to upgrade the 
firmware on the device. Still in the terminal, you’ll want to 
activate the firm ware upgrade software with: 

| $ sudo rpi-update 

A^ Extra configuration 

\0w At this point, you might want to tweak the Pi a little 
further To bring up the initial configuration screen, you’ll need to 
go back into the terminal and launch it with: 

| $ sudo raspi-config 


Art Advanced options 

From here you can activate some extra options that you 
might need in the future. Enabling the Pi camera driver is a good 
first step, and you can even have it boot to Scratch if you want to 
focus on fun game development. Otherwise, there are also some 
overclocking options that you can consider if the system starts 
getting slow for you. 




HARDWARE 




/\Q Accessorise your Pi 

\JW Just setting up the operating system on the Raspberry 
Pi is only a small part of the process - we also have to consider 
the hardware surrounding it that will actually make it usable as 
a desktop replacement 


m 




W Anything else? 

Our standard desktop PC setup is complete, with 
one USB port to spare, You can use that single port for USB 
sticks or portable storage, or you can invest in a powered 
USB hub to give yourself more connectivity options. Otherwise, 
investing in a good, 2A power supply will make sure you're never 
short on power for anything. 


Below You can run 
a pretty decent 
Minecraft server 
for a handful of your 
friends with the Pi 2 


IT Monitor to see 

I I The Pi can output a maximum of 1080p, which in normal 
display terms is 1920x 1080. While it only outputs in HDMI T a lot of 
modern monitors do have an HDMI input. If you don’t want to get 
a brand new monitor though, you can always get a HDMI to DVI or 
HDMItoVGAadapter. 


#*1 Human input devices 

l\# Standard USB keyboards and mice are best suited for 
this task, much more so than a lot of the wireless keyboard and 
mouse combos that are popular among Pi users. However, 
don’t try and save on USB ports by getting a keyboard with USB 
connections of its own: the Pi cannot power USB hubs, even just 
two on a keyboard. 


TO Case for protection 

\mm The Pi is pretty sturdy and we’d be lying if we said we didn’t 
regularly keep ours out of a case, however, it’s not indestructible. 
While we’re doing a lot of different projects involving accessing 
different components, a desktop Pi doesn’t require this level of 
access. We like the Pimoroni Pibow cases, but there are several 
other secure, protective alternatives. 


■* 


B Wireless for Internet 

While some people are fine using wired connections, not 
everyone has that luxury. Wireless dongles are a perfect fit for 
the Pi, especially now they’re almost no larger than the USB 
port themselves. However, not just any dongle will work and 
you'll have to check against this list to make sure that you get a 
compatible one: http://eiinux.org/RPi_USB_Wi-Fi_Adapters. 











MAKE A PI 2 DESKTOP PC 
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T|T Adding extra software 

Iw We’re not quite done getting our Raspberry Pi desktop 
ready just yet. We need to add some extra software to make it 
feel more like a real desktop. While we already have a browser 
installed and some of the basics, the first other piece of software 
we should add is an office suite. 

1/ Work with LibreOff ice 

IO LibreOff ice is not installed by default, but as the premier 
open source office suite, or Linux office suite in general, it is 
readily available on Raspbian, which is useful. Open up the 
terminal and install it with the following: 

| $ sudo apt-get install libreoffice 


GIMPfor photos 

1 1 This is the big one - while the original Pi was not quite able 
to handle LibreOffice, it was useless trying to use GIMP. Now 
GIMP works just fine, although more complex tasks might make 
it s low down j ust a touc h . I nstall it with : 


| $ sudo apt-get install gimp 


I LibreOff ice is not installed by default, 
but as the premier open source office 
suite, or Linux office suite in general, it 
is readily available to use on Raspbian, 
which is useful 



Above With the Pi 
2, you can run a full 
office suite without 
running into any 
awkward slowdown 
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IQ XiX for music 

I 1 w If you need to listen to music while you work, one of the 
best pieces of software to check out is XiX. It’s available on the Pi 
Store. It’s a free download and you can find the Pi Store in the Pi 
menus to install it 


IQ Pi for desktop 

I W Now we are set up you can start properly using your 
Raspberry Pi as a desktop system, while still making use of the 
educational capabilities when need be. The software repository 
and Pi Store should contain any other software that you would 
want or need to make the most of your new Pi system. ■ 
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3D-printed If you have already 

invested in a 3D printer or otherwise 
have access to one, the material cost 
of printingthe parts is negligible 









Camera module The camera 

module’s lens has been removed and 
it is placed below a4,5-inch mirror, 
which forms the image 




Optical tube 3D-printingthis I 

part of the PiKon would have been 
very inefficient, so Andy and Mark 
used readily-available venting duct 
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Focusing Things get a little more 

complex down towards the base and 
some Meccano pieces are used to 
hold everything together 




Components list 


Raspberry Pi 
Camera module 
3D printer 
5 CAD files to print 


Oil. I 


Hrir 


White venting duct 
Small square of aluminium 
Focusing knob 
Meccano pieces 
Tripod 


• • 


4i 


& 




The3D-printed base for the telescope is 
also composed of pieces of Meccano as well 
as the small square of aluminium 

Here is an example of the kind of photo 
that can betaken with the PiKon telescope: 
the Moon, with enough detail to be able to see 
its craters and surface texture 
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HOW I MADE: PIKON 



Tell us how you began your project 

I Mark Wrigley I run this small company 
called Alternative Photonics and 
like to find out about new technologies. 
When Sheffield’s Festival of the Mind 
came along I thought of what could we 
put together in terms of things that are 
new and disruptive, and that’s how the 
whole project started. The two things I 
was interested in were using Raspberry 
Pis for photography and 3D printing. 
With 3D printers you’ve got a device in 
the ballpark of £500, putting it amongst 
the price you’d pay for consumer items, 
so manufacturing is something you can 
do at home. There are companies who 
will print something for you, so you send 
in a design and they’ll produce it. And 
there are maker communities - Andy 
runs a group called Sheffield Hardware 
Hackers and Makers. 

Sheffield Hardware Hackers 
and Makers is for anyone off the street 
to come along to if they want to hack 
and make things. I set it up as part of 
the original Rep Rap project that ran on 
the Internet quite some years ago [Ed: 
RepRaps are 3D printer kits that can 
print parts for more RepRaps]. I found 
that there were quite a few people 
building printers who got to a certain 
point and then got stuck, so I set up 
this group originally to be a drop-in for 
people to come along to and get the help 
they needed. 


Andy, what was your role in the PiKon? 

I helped Mark pick a 3D printer 
that was going to be pitched right for his 
skillset and then, as he was building up 
the printer, when he got to bits where 
he got stuck he’d bring it along to the 
Hardware Hackers group and say ‘It 
doesn’t do this right* or ‘I can’t get it 
to do that’, and we’d work through the 
problems together. Once he’d got his 
printer going, I worked through the CAD 
software with him to see what was 
available thatwas open source and within 
his capabilities. There are various things 
you can’t do with a 3D printer when you 
design parts, so we had a conversation 



about that and I gave him the shortcut to 
get working parts out quicker. 

How does the PiKon work? 

Most telescopes work on the 
principle that you have some sort of 
object lens or mirror which forms an 
image and then you use an eyepiece 
to examine that image, so it’s usually 
what’s termed as a virtual image. With 
the PiKon, what we’re doing is using 
the objective device, in this case a 
4.5-inch (335mm) mirror, to form an 
image and then placing the Raspberry 
Pi camera without its lens - so just a 
sensor - where the image is formed. So 
effectively, instead of using an eyepiece 
we’re examining the image electronically 
by placing the Raspberry Pi sensor 
there, and the sensor is suitably small so 
we’re able to examine a fairly small area 
of the image. 

What kind of resolution do you get? 

At the moment, the setup 
that we’ve got is equivalent to a 
magnification of about 160, If you 
look at the Moon, the field of view of 
your eye is about half of one degree; 
the PiKon’s maximum field of view 
is about a quarter of one degree, so 
effectively you can see about half the 
moon in full frame. The next thing I’d 
like to do is look at planets. In terms 
of its resolution, the PiKon’s sensor is 
five megapixels, which is 2500x2000 
pixels. If you’re going to reproduce 
an image in print you’d normally use 
something like 300dpi, so 5MP would 
allow you to reproduce something like 
an A4 image. On a computer screen 
all you need is 72dpi, so what I’m quite 
interested in doing next is seeing how 
much magnification we can get simply 
by cropping - so literally throwing away 
some of the pixels to be able to zoom in 
on something like a planet. If you read 


the Astronomy for Beginners stuff, they 
talk about needing a magnification of 
200-250 to be able to observe planets, 
so I’m hoping we can do things like see 
the rings of Saturn. We’re not out to rival 
the Hubble - we think that what you’ve 
got is a reasonable instrument and you 
can do a few interesting things with 
it. The other thing is that because it’s 
using a Raspberry Pi sensor instead of 
an eyepiece, you’re immediately into the 
world of astrophotography rather than 
doing observations, so that’s the sort of 
way we're going. 

How doyou controlthe PiKon’s camera? 

We would like to do it better! 

At the moment it’s done through 
the command line. I’m not a Raspberry 
Pi programmer... So we’re using 
raspistill at the moment, which gives 
you a certain number of seconds of 
preview and then takes the picture, 
so it’s a bit clunky. I’m talking to a guy 
who’s into Raspberry Pi and is also a 
photographer, and he’s written some 
programs where you have a shutter 
button. The next thing to do then is to 
control PiKon from an input/output 
device like a shutter button and 
then give the JPG files you produce a 
sequential or a date-stamped filename. 
One thing I’d like to see next is if we 
could get this hardware out into the 
public and attract people to actually 
come along and develop more and more 
software for it. I tried taking pictures of 
the International Space Station with an 
ordinary camera, for example. It’s realty 
difficult because suddenly this dot 
comes flying across the horizon and you 
have to swing around, get your camera 
lined up, press the shutter and so on. 
One thought I had was it would be nice 
if you could take multiple shots with the 
PiKon - you press a button and it keeps 
taking a photograph every five seconds. 


The setup we’ve got is equivalent 
to a magnification of about 160 



is a member of 
the Institute of 
Physics and holds 
alicentiateship 
with the Royal 
Photographic 
Society 


was an early 
contributor to the 
RepRap project and 
runs the Sheffield 
Hardware Hackers 
and Makers group 


The Raspberry Pi 
Foundation website 
featured a project 
that mounts the 
Pi and camera 
onto a telescope 
and captures 
great images bit* 
ly/1qTp3Pb 


If you Ye interested 
in astrophotography 
and developing 
software for 
PiKon, checkout 
these astronomy 
packages: 
blt.!y/100wj65 
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Make use of cutting-edge web technologies to take control of a 
remote controlled car with a smartphone or tablet. . . 


BUILD A RASPBERRY PI-CONTROLLED CAR 




Web technologies are moving forward at a huge pace, cloud 
technologies are bringing mass computing to individuals, 
and hardware has reached a perfect moment in time where 
sensors, displays and wireless technology have all evolved 
into efficient and affordable devices. We truly are at a point 
where nearly anyone can take an idea from nothingto a working 
product in a week and at very little cost. Just like this project, 
which is fun, quick and easy to build on and a fantastic way to 
learn. We’re going to grab an old remote-control car, rip off its 
radio receiver and replace it with the Raspberry Pi, hook it up on 
the network, fire up a bleeding-edge web server and then get 
your smartphone or tablet to control it by tilting the device. By 
the end of this, not only will you have a fun toy - you will have 
learnt about the basic technologies that are starting to power 
the world's newest and biggest economy for the foreseeable 
future. Welcome to tomorrow! 


r ^ 
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HARDWARE 


Raspberry Pi-controlled car build process 


Components list 

■ A toy RC car with two 
channels (steering and drive) 

■ Adafruit PWM !2C 
servo driver 

■ Female-to-female 
jumper cables 

■ 5V battery power bank 
Estimated cost: £60 / $100 


Components from 

www.modmypLcom 


Before you can take control of your car wilh a smartphone, you'll 
need to make some significant changes to the chassis 


To help our toy car come to life using the 
latest web technologies and our credit 
card-sized computer, we’re going to 
need to make some pretty significant 
changes to its workings. Fortunately, 
the most complex aspects of the build 
can be accomplished with a couple 
of affordable purchases, namely a 
servo controller board to take care 
of the steering and throttle, and a 5V 
battery pack to keep the Raspberry Pi 
running smoothly. 


m Identify and remove old radio 

This project is effectively replacing the car’s normal 
transmitter and receiver. Notice the three sockets on the original 
receiver: one goes to the motor controller and one to the steering 
servo. Some remote-control cars also have separate battery for 
the electronics, but those (especially with an electronic speed 
controller with BEC) get their 5V power supply directly from 
the speed controller, saving on components, f you don’t have 
a speed controller with 5V BEC, you’ll need to get a 5V supply 
elsewhere. Many shops seLl 5V battery power supplies - often as 
mobile phone emergency top-ups. www.modmypi.com sells a 
suitable 5V battery power bank for under £20. 









BUILD A RASPBERRY PI-CONTROLLED CAR 


We’re using the Raspberry Pi’s 
I2C bus to control the servo 
interface board 


Attach the servo cables to 
the new controller 

We soldered our 16-channel I2C servo 
controller board from www.modmypi.com 
as per its instructions and simply plugged 
channel 0 (steering) and channel 1 (motor) 
headers onto it. There are six cables in 
total: the bottom two are ground, the 
middle two are the power and the top two 
are the PWM (pulse-width modulation) 
signals. This is a good time to think of 
places to mount the extra components 
and the best fixing method seems to be 
sticky-back Velcro. 

Con nect the I2C bus to the 
Raspberry Pi 

We’re using the Raspberry Pi’s I2C bus 
to control the servo interface board, 
which only needs four cables - they all go 
between the Raspberry Pi and the servo 
controller board as pictured. This month's 
accelerometer tutorial explains howto set 
up I2C on the Raspberry Pi. 

From top to bottom we need to use the 
1. GND, 2. SCL, 3. SDA and 4. VCC, which 
map directly to the same ports on the 
Raspberry Pi, Essentially this is power, 
ground and two communication channels 
- it’s all pretty straightforward so far... 

Hooking it up to the 
Raspberry Pi 

On a Rev 1 Raspberry Pi, the cables look 
the same. Though the Rev boards have 
different labelling, the physical pins are 
in the same place. Bottom left (closest 
to the RasPi power connector) is the 3.3V 
power; next to that is the SDA header, 


which is the data channel. Next to that 
in the bottom right is the SCL channel, 
which controls the clock of the I2C 
devices. And finally - on the top-right port 
- is the Ground. 

Overview of the main 
components 

You should now have the servo board in 
the middle with the steering servo and 
speed controller on one side and the 
Raspberry Pi on the other. The motor is 
connected to the other end of the speed 
controller (that end should have much 
thicker wires); the speed controller 
also has two thick wires going to the 
main car’s battery - in this case a 7.2V 
NiCad. We now have two very separate 
power systems with the high current 
motors on one side and the low current 
electronics on the other. Let’s make 
sure it stays that way! 

Find everything a home 

Now it’s time to find a home 
for the new components. Use plenty of 
sticky-back Velcro, tie wraps or elastic 
bands to keep everything secure and 
find spaces in the car’s body to hide the 
wires where possible. While it is possible 
to stick or screw the Raspberry Pi directly 
to the car, we recommend to use at least 
the bottom half of a case for added 
protection and ease of access. Insert your 
SD card, network cable or Wi-Fi dongle (if 
programming from another machine) and 
power supply. Sit back and admire your 
hacking. Next we’ll tackle the software 
side of the project... 
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HARDWARE 


Controlling your Raspberry Pi-powered car 

Control a toy car with a smartphone and the latest web technologies 


Now we have our fantastic Raspberry 
Pi-powered car all wired and charged, 
it’s time to make it come alive. We’re 
using the best web technologies 
that the JavaScript programming 
language offers, to harness the natural 
movement of your hand and wirelessly 
drive the vehicle. Each little movement 
will trigger an event that calculates 
what the car should do and then sends 
it over a socket connection up to 20 
times a second. 

Download and install 
the software 

To get the I2C connectivity working, 
you can follow the steps from pages 
64-65. Next we’ll need to find a home 
for our new project code - how about / 
var/www/picar? Type sudo nnkdir / 
var/www/picar in the terminal to make 
the directory and then change into that 
directory: cd /var/www/picar 

Now, to download the project using 
Git, type sudo git clone http:// 
github.com/shaunuk/picar. If you 
haven’t got Git, install it with sudo apt- 
get install git. 

This will download the custom 
software for driving the car, but we still 
need the web server and some other bits 
before we can start burning rubber... 

Download and install 
Node.js 

We now need to get the awesome Node, 
js and its package tool, the Node package 
manager (npm), Type sudo wget http:// 
nodejs.org/dist/v0.10.21/node- 
V0.10. 21-Tmux-arm-pi .tar. gz. This 
will download a fairly recent version of 
Node.js - the version Raspbian has in 
its repositories is way too old and just 


Step 07 



What youl need 


■ A RasPi car, ready to go 

■ An internet connection 

■ A reasonably modern 
smartphone/tablet 

Pi car source code 

github.com/shaunuk/picar 

doesn't work with the new technologies 
we’re about to use. Extract the node 
package by typing sudo tar -xvzf 
node-v0 . 10. 21-1 i nux-arm-pi .tar. gz. 

Configure Node.js 

To make it easy to run from 
everywhere, we will create symbolic 
links for Node and npm binaries. In the 
terminal, type sudo In -s /var/www/ 
n od e - v0. 10. 2 1-1 i nux-arm-pi /bin/ 
node /bin/node and then sudo In 
-s / va r/www/no d e - v0 . 10 . 21-1 i n ux- 

arm-pi/bin/npm /bin/npm. Then, 
to get the extra modules, type npm 
install socket, io node-static 
socket, io adafruit-i2c-pwm-driver 
sleep optimist 

Get to know the project 

Now we have everything, you 
should see three files: the server (app.js), 
the client (socket.html) and the jQuery 
JavaScript library for the client. The 
server not only drives the servos, but it 
is a web server and sends the socket, 
html file and jQuery to the browser when 
requested - it’s a really neat and simple 
setup and just right for what we're trying 
to achieve. 

Below All you need to finish off your project is 
access to a smartphone or tablet 








Above You need to adjust some of the variables tocontrolyour 
particular remote controlled car set-up 


ftC Test the servos 

* ' Our handy little program (app.js) has a special mode 

just for testing. We use two keywords here: beta for servo 0 
(steering) and gamma for servo 1 (motor control). Type node 
app.js beta=300. You should see the front wheels turn. Now the 
numbers need experimenting with. On our example, 340 was left, 
400 was centre and 470 was right. Do the same for the motor by 
typing node app.js gamma=400 and take note of the various 
limits of you rear. 

Configure sensible defaults 

Now you know what your car is capable of, we 
can set the defaults in app.js and socket.html, Edit app.js 
and find the section that says ‘function emergencyStop’. 
Adjust the two numbers to your car’s rest values. Then open 
socket.html and adjust the predefined values under ‘Define 
your variables here’. 


Going for a spin 

\M 9 We’re almost ready to try it out, but you need to know the 
IP address of your Pi car, so type ifeonfig at the terminal. Then 
fire up the app by typing node app.js. Now grab the nearest 
smartphone or tablet, making sure it’s on the same network 
as your Pi. Open the web browser and go to http://[your IP 
address]:8080/socket.html. You should get an alert message 
saying ‘ready’ and as soon as you hit OK, the gyro data from your 
phone will be sent to the car and you’re off! 











BUILD A RASPBERRY PI-CONTROLLED CAR 



We’ll harness the natural movement of your 


hand and wirelessly drive the vehicle 


Full code listing 

socket.html 

<html> 

<head> 

<scr ipt src=”jquery-2.0.3.min.js” language^' javascript '’></ 
script> 

<script src=”/socket,io/socket.io. js”x/script> 

<meta name= f ’viewport” content=”user -seal able- no, initial- 
scaled. 0 f maximum-scaled. 0;’ f /> 

<script> 

// Define your variables here 

var socket = io,connect(window 1 Iocation,hostname+’:8080 , ); 

var centerbeta = 400; //where is the middle? 
var minbeta - ‘340 ? ; //right limit 
var maxbeta = *470’; //left limit 

var multbeta = 3; //factor to multiply the raw gyro figure 1 
by to get the desired range of steering 
var centergamma = 330; 

var ajustmentgamma - 70; //what do we do to the angle to get 
to 0? 

var rningamma - 250; //backwards limit 
var maxgamma - 400; //forward limit 

var multgamma = 1; //factor to multiply the raw gyro figure 1 
by to get the desired rate of acceleration 

window Jastbeta= J 0 J ; 
window, lastgamma=’0'; 

$(function(){ 

window. gyro = ‘ready’; 
alert(‘Ready — Lets race !'); 

»; 

window. ondeviceorientation - function(event) { 

beta = centerbeta+(Math.round(event.beta*-l)*multbeta); 
if (beta >= maxbeta) { 
beta-maxbeta; 

> 

if (beta <- minbeta) { 
beta=minbeta; 

} 

gamma = event, gamma; 

gamma = ((Math,round(event .gamma)+ajustmentgamma)* 
multgamma)+ centergamma; 

//stop sending the same command more than once 
send = *N’; 

if (window, lastbeta != beta) { send = ‘Y J } 
if (window, lastgamma != gamma) { send = ‘Y’ } 
window, last beta=beta; 
window, lastgamma=gamma; 

if (window, gyro -- ‘ready’ && send==’Y’) £ //don’t send 
another command until ready,,, 
window. gyro = ‘notready’; 

socket, emit(‘fromclient’ t £ beta- beta, gamma: gamma } ); 
window, gyro = ‘ready'; }} 

app.js 

//declare required modules 

var app - require^ http’).createServer(handler) 

, io - require(‘socket,io’),listen(app) 
f fs - require(‘fs J ) 

, static = require(‘node-static') 

, sys = requireCsys’) 

, PwmDriver = require(‘adafruit-i2c-pwm-driver’) 

, sleep = requireCsleep’) 

, argv = require(‘optimist’).argv; 
app.listen( ); 




Cl u 


idr 


device name of the <— 1 


breakout board 

pwm - new PwmDriver(0x40,Vdev/i2c-0’>; 


//set pulse widths 

setServoPulse = function(channel, pulse) { 
var pulselength; 
pulseLength = 1000000; 
pulseLength /= 60; 

prirvt(“%d us per period” % pulselength); 

puiseLength /- 4096; 

print(“%d us per bit” % puiseLength); 

pulse *= 1000; 

pulse /= puiseLength; 

return pwm.setPWMCchannel, 0, pulse); 

}; 

//set pulse frequency 

pwm,setPWMFreq(60); 

//Hake a web server on port 8080 

var file = new(static.Server)(); 
function handler(request l response) { 
console. log(‘ serving file’, request. url) 
file. serve (request, response); 

}; 

console. log(‘Pi Car we server listening on port 8080 visit «-■ 
http: //ipaddress: 8080/socket, html’); 
lastAction = 

function emergency5top(){ 

pwm,setPWM(0, 0, 400); //center front wheels 
pwm.setPWM( , 0, 330); //stop motor 

console, log(‘###EMERGENCY STOP - signal lost or shutting ^ 
down'); 

} 

if (argv. beta) { 

console. log(“\nPer forming one off servo position move 
to: “+argv. beta); 

pwm,setPWM(0, 0, argv. beta); //using direct i2c pwm module 
pwm,stop(); 

return process, exit(); 

} 

if (argv, gamma) { 

console, log(‘ ( \nPerforming one off servo position move 1 
to: “+argv. gamma); 

pwm.setPWMtl, 0, argv. gamma); //using direct i2c pwm module 

pwm.stop(); 

return process. exitQ; 


} 

//fire up a web socket server 

io, sockets, on^connectionh function (socket) { 
socket. on(‘fromclienth function (data) { 
console. log(“Beta: “+data,beta+” Gamma: “+data, gamma); 

//execC'echo ‘sa “+data+”’ > /dev/ttyAMA0 TJ , puts); //using 
http://electronics.chroma.se/rpisb.php 

//exec(“picar py 0 “+data,beta, puts); //using python 
adafruit module 


pwm. set PWM (3, p data. beta); //using direct i2c pwm module 
pwm.setPWM(l ? 0, data. gamma); //using direct i2c pwm module 
clearlnterval(lastAction); //stop emergency stop timer 
lastAction = setInterval(emergencyStop/1000); //set ^ 
emergency stop timer for 1 second 

»; 

}); 

process, on('SIGINT\ function() { 
emergencyStop(); 

console.log(‘ i \nGracefully shutting down from SIGINT 
(Ctrl-C)”); 
pwm.stopO; 

return process. exit(); 

1 ); 
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MPU-6050 ContainingaMEMS 

accelerometer and a MEMS gyroscope, 
this sensor reads the x, y and 2 axis 
channels with 16-bit ADC conversion 


Vero board Veroboard is great 

to tidy up wires in projects Like this, 
where they get in the way but can't 
really be run through a breadboard 


Robot Arm Available from MapLin 
Electronics and OWI Robotics, the arm 
comes with software for control even 
before you get the MPU-6050 involved 




Components list 


Raspberry Pi Model B 
Maplin Robotic Arm Kit With 
USB PC Interface 
MPU-6050 Six-Axis Gyro 
and Accelerometer 

■ 3 Mini Push Button Switches 
■Veroboard 

■ Velcro strap 

1m Ribbon Cable 


This robotic arm is one of the most used 
ones and there are tonnes of guides for it 

One of these buttons controls the light 
on the end of the robotic arm, while the other 
two open and close its gripper 
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HOW I MADE: ROBOT ARM 



What first inspired you to begin your 

robot arm project? 

The robot arm itself was one I’d seen 
years ago and I really wanted it because 
it’s something you can control yourself - 
it really captured my young imagination. 

I was volunteering at a science museum 
down here in Harlow and this club based 
around the Raspberry Pi sprung up, and I 
bought the robot arm because I wanted it. 
So then I had the Raspberry Pi thing going 
on at the same time and thought, why not 
meld the two? 

1 had this complicated system of key 
presses to get it to do anything, which 
was a bit boring, and then James Dali 
(one of the people who helps out with 
the club) gave me the idea of shoving an 
accelerometer on the top of it to give an 
idea of where it is. I took that and thought, 
‘What if I had the accelerometer on me 
and sort of used it to mirror the motion of 
my hand?’ So I looked around, searched 
up the accelerometer he was using (the 
MPU-6050) and then found it for about 
£5 on eBay - it’s normally about £30 from 
SparkFun but I’m on a student budget... 
A lot of the code I’ve used is borrowed 
but open source, and people have said 
it’s fine, so then I went through and had 
two programs - one that could control 
the arm, one that took the input in from 
the accelerometer - and kind of just 
smushed them together. It’s not that nice 
to look at, but it works and that’s all that 
really matters. 

So what exactly are you read ing with 
that MPU-6050? 

There’s the gyroscope and the 
accelerometer in the code I’d found - 
you can use one or the other, but the 
gyroscope is very good for degrees 
over time and it tends to drift, while 
the accelerometer is good for sudden 
turns and for measuring gravity. If you 
compare the two to each other then you 
can get a rough angle all of the time, so 
it’s essentially the accelerometer and 
the gyroscope used together to correct 
the faults with one or the other. It’s got 
two axes of motion - pitch and roll. 


Take us through the code itself. 

So in the first bit it finds where the 
actual I2C interface is and there’s a quick 
setup - I’ve got three buttons on there 
to control the gripper and the lights, so 
it sets those up - and then there’s a bit 
which is using the USB library to find the 
robot arm, then spitting it out if that’s an 
issue. There are a couple of definitions 
for some functions to actually move 
the arm, so it’s a little bit easier - each 
motor direction is a different binary 
number - and then there are more 
definitions for setting up reading data 
from the accelerometer and a bit of 
maths for making sure the gyro and 
the accelerometer are both giving the 
correct angle. Then there’s this while 
loop with a try inside it that is just pulling 
the accelerometer for data, spitting out 
the maths stuff , before just checking 
that the angle given is within a certain 
range. If it is, move this motor left (for 
example), or if a button is pressed then 
it turns a light on. The only problem I’ve 
had with it is that to actually move it, it 
requires a change in angle - so there’s 
not a continuous thing. I have to wave my 
hand a little bit, but there’s that degree 
angle and if I trip it then it’ll move around. 

Have you considered addingany more 
forms of control? 

Yeah, I’ve done a lot of research into this. 
In terms of other ways to control it, I quite 
like the intuitiveness of it - to rotate 
and move this arm you are moving your 
own arm, so that’s something I’ve been 
focussing on and trying to get even more 
intuitive. Trying to get some sort of - I 
bought an Arduino at some point - trying 
to build an actual robotic hand and then 
spreading out from there. Eventually, 
my big plan - many, many years in the 
future - is to have an entire sort of human 
body that is controlled by the movements 
of the user, but that’s a very large plan 


which i haven’t put too much into just 
yet! But essentially, the prototype that 
people have done before is sort of having 
pot sensors - potentiometers - on 
the fingers just to measure the actual 
rotation and closing of the fist, then 
having that represented with servos 
and then possibly doing that with actual 
pieces of string to sort of emulate the 
tendons. So you’d have a single servo, ora 
couple of servos, in an arm bit that would 
pull string which would close each finger 
in turn. 

Another idea, which seems to be 
one of the most viable, is having it 
completely brain controlled... There’s 
a fair amount of interest in reading 
brain activity - you can do it with the 
NeuroSky, for example. There’s quite a 
nice open source project which I might 
end up using because it has four inputs, 
so you can measure at least two things 
at once and that seems to be a fairly 
interesting place to go. It’s expensive 
though, and if you’re going open source 
then they have a lot of warnings on the 
websites saying that you do this at your 
own risk, this is not a medical product, 
you may fry your brain... 

What is the next step then? 

Further projects would probably be 
replacing the motors. Because it’s 
motor-driven, it’s timing-based, so 
having something with servos instead 
where I can have a definite angle would 
be a lot more useful, a lot more precise 
and wouldn’t tend to go... one of the 
problems with it is that if you tell it to 
keep going in one direction, it will keep 
going in one direction whether it wants 
to or not, and there’s this awful grinding 
of gears as it attempts to go in one 
direction and can’t. So that will probably 
be a new arm, a new robot, trying to get 
it to be a bit more nice-looking and a bit 
more precise. 


Another idea is having the arm be 
completely brain controlled 


is a 

student helping to 
run a Raspberry Pi 
dubfromascience 
museum in Harlow, 
where they have 
worked on projects 
ranging from a robot 
arm to a portable Pi. 


The robot arm that 
Joseph is using can 
be bought from 
Maplins in the UK 
(bit.ly/1Da9BrT) 
or ordered from 
Adafruit elsewhere 
in the world (bit. 
ty/lyXLDQt). There 
are many guides 
online to get you up 
and running, such 
as this one: 
blUy/tAKdOQU. 


NeuroSky has a 
whole product 
family dedicated 
to EEG and ECG 
biosensors, 
incLudingthe 
popular MindWave 
headsets (neurosky, 
com), and there 
are a few hacks 
available too (bit. 
ty/1C7wOSP). 
OpenBCl is a 
burgeoning open 
source project 
dedicated to brain- 
computer interfaces 
(openbci.com). 
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Finally create a more powerful and capable 
HTFC using the Raspberry Pi 2 and the excellent 
OpenELEC project 


We know people who just have a Raspberry Pi for XBMC, 
now called Kodi. It’s a great idea and a great use for the Pi 
- it works just well enough that you can easily play media 
locally or over the network. The biggest issue came with 
GUI response on the original Model Bs, and a Lack of USB 
ports for connecting up everything that you want. 

While optimisation over the last few years has helped, 
the leap to Raspberry Pi 2 has basically solved all of these 
problems by giving you much more powerful hardware to 
play with. So if you’re looking to upgrade or finally take the 
plunge, this handy guide will help you create the perfect 
Raspberry Pi 2 HTPC. 


Choose the software 

\^l In the past. Pi HTPCs were just a choice between 
Rasp BMC and OpenELEC. However, RaspBMC is on a bit of a 
hiatus and OpenELEC is your best bet for getting the most up- 
to-date software. There’s not a massive difference between the 
two, as they both run XBMC. 

Get the software 

\M^m Head over to openelec.tv and Look for the Download 
section. There’s a specific Raspberry Pi section which is split up 
into original (ARMv6) Pi and the newer Raspberry Pi 2 (ARMv7). 
Grab the i mage file from this page f o r the Pi 2. 



What youl need 

OpenELEC openelec.t\ 

HDMl cable 
USB IR receiver 
IR remote 
Case 

Dedicated power supply 
Optional USB storage 
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|%#\| Install to card 

\#^JP Open upthe terminal and use fdisk -l to determine where 
your SD card is located on your system. Something like /dev/sdb 
or /dev/mmcblkO will be ideal. Navigate to the image using cd and 
install it with dd using: 

| $ dd bs=lM if=0penELEC-RPi2. arm-5.0. 5. img of-/dev/ 
mmcblkC 

M First boot 

Plug in your Raspberry Pi, either to your TV or to 
another screen just to begin with, and turn it on. OpenELEC 
will resize the SD card partitions and write a few extra 
programs before finally booting into Kodi, 



AP Configure Kodi 

Go through the basic wizard to get through the 
interface - if you are connecting via wireless you will need 
to go to OpenELEC in the System menu and activate the 
wireless receiver before selecting your network and then 
entering your password. 



ftjL Add network shares 

You can stick a portable hard drive or USB stick into 
the Pi for storage, but the best method is really to stream 
over the network. Go to File manager under System and Add 
source. Go to Browse and choose your network protocol to 
browse the network or alternatively, add it manually. 

A^ Build your media centre 

\/# Placement of your Raspberry Pi is important As it’s 
going to be out all the time, we highly recommend getting a 
case for it - the Pibow cases from Pimoroni are quite well 
suited for this type of use as they are sturdy and can be 
attached to the rear of some TVs. 

AQ IR sensors and controllers 

Kodi can be controlled with a number of different 
things - including USB game controllers and compatible IR 
sensors. We’ve used FLIRC in the past, but if you have your Pi 
behind the TV, you’ll need a sensor on a wire that can stretch 
to a useful position. 

Future updates 

OpenELEC has the excellent ability to update itself 
without needing you to reinstall it every few months, meaning 
you won’t need to do much maintenance on it at all. Now you 
can sit back and enjoy your media much easier than before. 


Above Kodi really is 
designed to be used 
with a remote, and 
there are some great 
guides to using them 
on the OpenELEC 
site: bit.ty/IBOAERv 


Live TV 



Kodi does have the 
ability to play live 
TV viaaTV tuner, 
and you can also 
record stuff as well 
as long as you have 
the local memory. 
The main thingyou’U 
need to invest in is a 
compatible TV tuner, 
a List of these is 
available here: 
bitly/1r3mEVj 
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HARDWARE 



Flood-proof your basement in just 19 lines of code, or 
easily tweak the project to create your own personalised 
alarm system. . . 


Flooding saw hundreds of homes right 
across the world underwater this year, 
and many would have benefited from 
having Just that little bit extra warning. 

In order to be better prepared for floods, 
we’re going to show you how you can 
prototype your own wireless flood sensor 
in less than ten minutes. Building it 
might give you just enough warning to 
dash home from work, move valuable 
items upstairs and take the lawn mower, 
caravan and motorbike to higher ground. 
Handily, it can also be used to detect 
toilet flushes, water butt levels or any 
liquid level rise or fall at all - so it’s not just 
somethingfun to try out, it’s practical too! 

Sending tweets 

Sending a tweet used to be really easy, if 
a little on the insecure side. These days 
you need to register an application with 
your Twitter account - you do have one, 
don’t you? If not, go create one at www, 
twitter.com. At first this project can look 
a little daunting, however it can be done 
painlessly in less than five minutes, if you 
follow these steps closely! 



Whatyoull need 


■ Ciseco Raspberry Pi 
Wireless Inventors Kit 

shop.ciseco.co.uk/raswik 

Float sensor 

shop.ciseco.co.uk/float-switch 

■ DC power supply between 
6vand 12v 


m Link Twitter to mobile 

Make sure your Twitter account has a mobile phone 
number associated with it. In your main Twitter account, click 
the gears icon at the top-right and then ‘Mobile’ in the list. At 
this stage, just foLlow the instructions on screen. 

Set it all up 

With your Twitter username and password, sign in 
to https://apps.twitter.com and click on the button ‘Create 
an application’. In the name field we suggest you use your 
Twitter account name, add a space and then write ‘test’. For 
the description, just put Test poster for Python'. Finally, for the 
website you can put anything you like. For example, http://www. 
mywebsite.com - but it’s important you don’t forget the ‘http://’. 


Enable reading and writing 

Since you want to be able to send tweets, click on 
the ‘Settings’ tab, change to ‘Read and Write’ and then dick 
‘Update’. This mighttakeafew seconds. 



f\i Generate codes 

Now go back to the ‘Details’ 
tab. You will see that an ‘API key’ and 
API secret’ are visible, and that there’s 
a ‘Create my access token’ button. 
Click that button to obtain all four of the 
codes you'll need. If you did this before 
Step 2, or it still says ‘Read’, all you 
have to do is click the button to recreate 
these codes. It really is straightforward. 


Remember the codes 

Earlier on ‘API’ was called 
‘consumer’, and you might have come 
across this before in examples on the 
web. We suggest copying the following 
essentials into Notepad so they don’t 
get lost: API key, API secret, Access 
token and the Access token secret. 







Right The Wireless Invertors Kit enables 
you to connect a Raspberry Pi to an Arduino 
module from the otherside of yourhouse 






MAKE A TWEETING WIRELESS FLOOD SENSOR 


F Tweepy is an easy-to-use 
Python Library that works great 
for accessing the Twitter API 


No RasWIK? 

Not to worry, using different hardware 
is always a possibility when playing 
around with the Raspberry Pi. The 
reason we chose to use the RasWIK is 
simply because everything except the 
float switch is in the box and preloaded 
with software, making it much easier to 
get up and running quickly. As a bonus 
addition, this software is also available 
to download for free. 

To build this with a conventional 
Arduino or clone, you’ll need a USB 
cable and to leave it ‘wired’, or use 
serial-capable radio modules such as 
the Xbee or APC220. We are, after all, 
only sending and receiving plain text. 

The Arduino sketch used can be 
downloaded from http://github.com/ 
CisecoPlc/LLAPSerial, while the SD 
image for the OS we used is based on a 
stock version of Wheezy, which can be 
downloaded from http://bit.ly/SfhLLl. 



m Start simple 

To get going with your flood 
sensor, simply plug in the Slice of Radio 
to your Pi and insert the preconfigured 
Raspbian operating system. 


Goto LX terminal 

Power up the Raspberry Pi, log 
in and type STARTX to start the desktop. 
Double-click the LX Terminal and type 
the following into the black window: 

| min icon -D /dev/ttyAMA0 -b 9600 



Make the connection 

Connect the float switch to the XinoRF ground pin 
(marked GND) and digital I/O pin2. Then, power up the XinoRF 
(you will see a— STARTED- displayed in minicom) 


f\Z Test the sensor sends messages 

Wiggle the sensor up and down (you should get a-- 
D02HIGH- when the sensor position is up) and seethe RXR LED 
on the XinoRF flicker with each message sent. 


Full code listing 


import tweepy, serial, time 
API_key - 
API_secret - 
Ac cess. token = 

Access. token. sec ret = 

auth = tweepy. OAuthHandler(API_key, API.secnet) 

auth . set_access_token (Access. token , Access.token.secret) 

api = tweepy, /PI (auth) 


ser = serial. Serial( , 9600) 


while True: 

Seriallnput - ser.read(12) 
if Seriallnput = : 

TimeNow - datetime. datetime. now() 

DS = TimeNow. strftime( ) 

AlertText - 

print (AlertText) 

api . update.statu s( AlertText) 

time. sleep (10) #stop fast re-triggering 

ser.flushlnputQ 


Install Tweepy 

Tweepy is an easy-to-use Python library that works 
great for accessingthe Twitter API. For more information orto 
check out the documentation, visit https://pypi.python.org/ 
pypi/t weepy/2. 2. Type in a shell windowthe following: 

| sudo pip install tweepy 

Put the sensor to work 

Test your prototype using a regular saucepan of water. 
If you want to put your flood sensor to real use then place it into 
a waterproof box and ensure it is mounted securely. 



<*\ 
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Pi-powered Bigtrak 


Take a toy, a Raspberry Pi and a PS3 controller; add a dash of Python 
and some solder for the perfect remote-controlled gadget. . . 



What youH need 


www.bigtrakxtr.co.uk/shop/bigtrak 

Breadboard and cables 
Motor driver bit.ly/1 iOnFuj 

USB Battery pack 

amzn.to/1h2PBil 

PS3 DualShock controller 
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BUILD A RASPBERRY PI-POWERED BIGTRAK 


The Raspberry Pi is a small, low-cost computer designed to 
promote an interest in computing and programming - but it 
doesn't have to be straight-laced computing. In fact, in this 
article we’ll be showing you how you can use it to turn a Bigtrak 
into a robot. That's educational, right? 

The Bigtrak is a toy that takes in a list of straightforward 
commands (Go forwards, turn left, turn right) and then 
executes them. To make things more interesting we’re going to 
remove the existing circuitry and replace it with a Raspberry 
Pi, using a small motor driver to safely control the motors 
in the Bigtrak, which we’ll then set up to be controlled via a 
PlayStation 3 DualShock controller. 

Everything required on the software side comes pre- 
installed on the latest Raspbian OS images, so all we need to 
translate changes from the controller to the motors is a small 
Python script that uses thePygameand RPI.GPIO modules. 

Opening up the Bigtrak - the easy bit 

I Before we can make any changes to the Bigtrak we need 
to get inside. First, flip the Bigtrak upside down and remove the 
nine screws from around the edge. These are mostly easy to get 
at, however the ones on the front may require a more slender 
screwdriver to reach them. 

Opening up the Bigtrak - the fiddly bit 

The last two screws are located underneath the grey 
grille on the back. This grille is held in place by four plastic 
tabs that need to be pushed in while at the same time sliding 
the grille away from the Bigtrak. This can be quite tricky as 
there is limited space to get extra hands in to help out. It can 
help to wedge some thin plastic items (eg a guitar pick) into 
the sides to keep those two tabs unlocked, while using your 
fingers to push in the bottom two tabs and slide the grille 
upwards, allowing you to remove the screws. 


Removing the top 

Put the Bigtrak back onto its wheels then carefully 
loosen the top and lift upwards. The lid is connected to the 
base with a ribbon cable and a switch, so only pull the top up far 
enough for you to tilt it to one side and expose the inside. 

With the lid lifted up onto one edge, remove the screw 
holding the switch in place and detach it from the lid. Next, 
you need to unscrew the two screws on the PCB that hold the 
ribbon cable in place and let it slip free. 

With the switch and ribbon cable disconnected, the lid 
should now come free and can finally be completely removed 
from the base of the Bigtrak. 

M Cut the wires 

Cut the wires leading to the main PCB. The ones for 
the switch and power should be cut close to the PCB (so we can 
reuse them later) whereas the ones to the LED and speaker can 
be cut wherever you like. 

Remove the engine 

Turn the Bigtrak upside down and remove the four 
screws holding the engine in place (this will reduce the chance 
of soldering iron damage to the main body). Carefully turn the 
Bigtrak back overand lift it up until the engine slips free. 



Step 03 







HARDWARE 


►The wires need to be long 
I enough to reach the back of the 
I Bigtrak, so be generous! 
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Rewire the motor 

Remove the solder connecting the RGB to the motors (a 
solder mop is useful here) and then remove the PCB. With the 
PCB removed we can now attach wires to the motors in orderto 
drive them from the Raspberry Pi, as opposed to the on-body 
commands. The wires will need to be long enough to reach the 
back of the Bigtrak, so be generous - after all, it’s far easier to 
trim long wires to length than replace short wires entirely! 

Having installed all of the wires, you can now replace the 
engine back into the Bigtrak. 


Connect the motor driver 

\Jw With the motors back in place we now need to build 
up a circuit to drive it from the Raspberry Pi. We've used a 
ribbon cable to connect the GRIO pins on the Raspberry Pi to 
a breadboard, before connecting it up to a Dual Motor Driver 
(http://proto-pic.co.uk/motor-driver-1a-dual-tb6612fng) to 
actually drive the motors. This keeps the higher voltage the 
motors require away from the sensitive GPIO pins. 

The connections made on the breadboard are listed in the 
table below. These values will be needed when writing the 
software and may be different depending on the breakout 
board you are using, and the Raspberry Pi revision. 


RPiGlPO 

Motor Driver 

24 

AIN2 

17 

AIN1 

18 

ST BY 

21 

BIN1 

22 

BIN2 


With the PWMAand PWMB pins directly connected to the 3.3V 
power rail, the motors will now always run at full speed for as 
long as they’re active. 


the breadboard 

\J W The breadboard is going to be installed on top of the 
battery compartment inside the Bigtrak, so the wires from the 
motors should be brought to the back to the unit and cable-tied 
into place. The wires to the batteries can also be brought back 
to the same place to help keep things tidy. 


AA Wire it all together 

\Jw in order to easily connect the motors and batteries to 
the breadboard we have soldered some modular connector 
plugs to the ends of the cable, allowing them to just push 
into place (these are available from www.maplin.co.uk/ 
modular-connectors-5348). 

With the breadboard installed (sticking it into place 
for support) we can now, after double-checking all the 
connections, plug the motors and power into it. To know when 
the motors are enabled (and reduce the chance of unexpected 
movement), the LED can be connected to the breadboard so 
that it lights up whenever the ‘standby’ pin is active, using a 
resistorto ensure it doesn’t pull too much current and go ‘pop’. 


Provide power 

1\# Power for the Raspberry Pi is supplied via a USB battery 
pack that is installed on top of the engine and can be held 
in place by a couple of cable ties or a Velcro strip. This type of 
battery is typically sold as a portable mobile phone or iPad 
charger - the one used here is rated at 8000mAh, able to 
power the Raspberry Pi for up to eight hours. 
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BUILD A RASPBERRY PI-POWERED BIGTRAK 


Vt Connect to the Raspberry Pi - adding cables 

I I As the Raspberry Pi will be mounted on the top of the 
Bigtrak, we need to run the ribbon and power cable through 
the top of the case. To do this, turn the top of the Bigtrak upside 
down and release the front two catches that hold the dark grey 
plastic in place - this provides a big enough gap to feed the 
ribbon cable and USB power cable through. Make sure that 
the red edge of the ribbon cable correctly matches up with the 
connector on the breadboard to save yourself from having to 
twist the cable inside the case. 

Connectto the Raspberry Pi - final steps 

With the top of the Bigtrak back on, the Raspberry 
Pi can now be put in place, keeping the GPIO pins towards 
the front to allow the ribbon cable to easily connect. As for 
the battery pack, we’re holding it in place with cable ties 
and sticky pads. In theory it’s possible to attach the bare 
Raspberry Pi to the Bigtrak, however this can cause the SD 
card to press against the edge and bend, so it's recommended 
to u se a case to p rotect the Rasp be rry Pi . 

Connect the ribbon and power cable to the Raspberry Pi, 
turn it on and it’s now ready to be told what to do. For setting 
up the software it may be easierto connect up a keyboard and 
monitortothe Raspberry Pi atthis point. 

IQ ConnectthePS3 controller 

1^ This should be a simple case of plugging the PS3 
controller into one of the USB ports, as all the software to 
support it is included in the default Raspbian OS image and it 
will be automatically detected as a joystick. To confirm that the 
PS3 controller has been detected, run Isusb and checked that 
it appears in the resulting list. 


Step 11 


W Run the software 

Now with the system all set up, it should just be a 
simple case of copying the ‘bigtrak. py’ file found on this 
issue’s disc onto your Raspberry Pi and running it. As the 
script accesses the GPIO pins, it will need to be run as the 
superuser, so launch it using: 

| sudo python bigtrak, py 

Now we can control the Bigtrak using the analogue sticks! 
Moving the left stick will control the left motor and moving 
the right stick will control the right. So, to move forwards push 
both sticks up, pull both down to go backwards and push one 
up and one down to rotate on the spot. 

If the analogue sticks are not controlling the Bigtrak as 
expected, double-check the GPIO connections to make sure 
that they are all as expected. 

T|T Next steps 

Now that you have a solid base for 
your Raspberry Pi robot, you can make 
further adjustments to it. Possible next 
steps could be: add a USB Bluetooth 
adaptor so the PS3 controller can 
be connected wirelessly: replace 
the breadboard with a Pi Plate 
or ‘Slice of Pi’ add-on board, 
allowing the Raspberry Pi to be 
installed inside the Bigtrak; connect 
up the RaspberryPi camera and a USB 
WiFi adaptor to stream video as you drive 
around; or add a robot arm! 













Tell me more about your hackable 

gaming tank. 

The Pi Panther robot is a smart, 
fast vehicle that you control using 
the Ubotia app on your smartphone. 
As it explores rooms, you can set up 
battlefields anywhere and fight your 
friends using the Ubotia software. Plus 
you can customise the tank with your 
own attachments. Unfortunately, we 
were only able to make around 22% 
[€5,000/$5,900] of our Kickstarter 
fund-raising goal. It’s just not enough 
fora large production run. 

Have you got any further plans for 
PiPanther, once the Kickstarter 
campaign has come to an end? 

Welt it’s not 100 percent ready - I 
mean, it is ready but it needs a little 


more work. When working on it I found 
several issues that needed to be fixed, 
both mechanical and electronic. My 
colleague and I (the electronics guy) 
spent hundreds, if not thousands of 
hours on this project but still more 
needs to be done. To be honest, 
the biggest problem is the casing - 
this white casing is 3D-printed, but 
because I designed it using relatively 
thin and highly precise elements, I 
couldn’t use the cheaper 3D printers 
that you can buy for a few hundred 
pounds. Instead I had to order the 
casing in from a specialised company 
that used selective laser sintering. So 
it's more expensive and the casing is 
very, very precise, but that expense is 
not acceptable for the production of 
the PiPanther on a large scale. 


So what makes up the PiPanther - 
what are the main components? 

Currently the chassis consists of four 
elements. Then there’s a Raspberry 
Pi, our PiPanther matnboard on top of 
that, two DC motors, two gearboxes, 
the tracks, one servo to rotate the 
turret. Then inside the turret there’s a 
mounted USB hub, because I designed 
PiPanther to use the Raspberry Pi 
Model A+, since it’s smaller and 
cheaper, but it only has one USB port. 
So on the turret you have two USB 
plugins and then the third USB port 
is for the Wi-Fi. We also have a Li-Po 
battery at the bottom of the chassis. 

Can you tell me more about the 
PiPanther mainboard? 

We designed it ourselves - it’s half 
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Recharge This panel flips right 

up to reveal a microllS B port beneath, 
so you can easily recharge Pi Panther 
between rounds 


the size of the Raspberry Pi and on it 
you have a DC-DC converter, which 
supplies 5V to the Pi, powerful motor 
drivers, a servo controller and a USB 
charger, so you can charge PiPanther 
directly using a microUSB cable - just 
plug it in, leave it for three hours and 
it’s charged. 

This mainboard is goingto be available 
separately for use in custom projects 
-is that right? 

Exactly. To drive a tank, you need 
to drive two motors - the left track 
and the right track - but instead of 
using tracks you can just use two 
wheels, so you can build your own 
wheeled robot instead. The steering 
is exactly the same. If you want to 
go forward then you power the two 
motors and if you want to turn then 
you just regulate power between 
the left and right motors. So you 
can use this board to drive your own 
robot - just plug into your motors and 
use the same mainboard but with Pi 
and Ubotia software. The main part 


(and the hardest part) of the Ubotia 
software was to provide live video 
streaming from the PiPanther to the 
mobile interface. I made that at a time 
when nobody else was able to do it, 
but unfortunately in the meantime, 
several other robots were developed 
with video streaming as well. I didn’t 
have too much time because I have 
a small child, but you have to believe 
me - I was the first one to create a live 
video stream from the Raspberry Pi to 
Android at that time! We achieved a 
video delay of less than one second, so 
you can drive it around in realtime. 

So how much of all this is being 
handled by the Raspberry Pi? 

The Pi runs Arch Linux and on that 
we have our PiPanther software, 
which is responsible for talking to the 
PiPanther mainboard using the serial 
interface, USART. Then that is used 
to control the motors, turret, status 
LEDs and give feedback from the USB 
charger. That software is written in 
C++ and also consists of a plugin 


Together we spent hundreds of 
hours on this project 


HOW I MADE: PI PANTHER 



The PiPanther mainboard is built to be an extension that 
attaches directly on top of the Raspberry Pi’s GPIO pins. It can work 
with both the Model A and Model B Raspberry Pis, and is capable of 
powering your own Ubotia-playing robot 

Land a direct hit in Ubotia and you’ll damage your opponent’s 
interface (it’s about a minute into Michat’s video: bit.ly/1BN4kpn) 



controller. So if you have plugins then 
you can put in shared libraries that are 
loaded at runtime by this software, 
and using the API you can control 
your own attached plugins using 
standardised JSON-based protocols. 

Your website says that these custom 
plugins could affect Ubotia gameplay 
- a robotic arm for a capture the flag 
match, for example. 

Yes, currently we only have the 
standard gun plugin, but if someone is 
familiar with electronics (and I think a 
lot of Raspberry Pi fans are) they can 
easily create their own plugins. I put a 
lot of effort into making the API user 
friendly. You can create, for example, 
an LED torch to replace one of the 
gun attachments and you can then 
drive around in the dark wherever you 
want - under your bed, behind your 
wardrobe - and hide to create sniper’s 
nests. Or you could create a simplified 
robotic arm for the back of the tank 
to throw other tanks, knock them 
out of the game area. You can also 
make game elements like a landmine: 
you can create a small box that uses 
the same mechanism as the guns 
(infrared) and then put it in the arena 
so it explodes when people go near it. 


Find out how 
to make your 
own PiPanther 
pLugin and see a 
breakdown of the 
plugin architecture 
over at ubotia. 
com/posts/plugin- 
specification. Keep 
an eye on the main 
PiPanther page for 
any updates on 
the project. 


If you’re thinkingof 
making your own 
custom Ubotia 
robot, you can find 
our guideto building 
and controlling 
Raspberry Pi- 
powered cars inside 
Raspberry Pi The 
Complete Manual 
(biUy/1xg2vuQ), 
along with plenty 
more besides. 
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HARDWARE 




What youl need 

■ Raspberry Pi Model B 

■ H DM I Pi kit 

■ Class 10 SD Card 

■ 5.25V Micro USB power 
supply 

■ USB keyboard 

■ Wi-Fi dongle 

■ internet connection 


Digital signage is a huge market in modern times, and 
increasingly we are seeing digital advertising in the public 
space - be it on street billboards, shopping centres and even 
in some city taxis. Screenly is an exciting piece of software 
from Wireload Inc that has set out to reduce the barriers to 
entry of the digital signage market by employing a Raspberry 
Pi as its mam hardware component for the individual signage 
nodes. With the powerful VideoCore IV graphics processor at 
the heart of the Pi and its low electrical power consumption, 
using it as a digital signage platform is a no-brainer. 

Our expert has been using Screenly a lot recently for some 
projects and it truly is a really great piece of software. He was 
also one of the first backers of HDMIPi on Kickstarter, and when 
his reward arrived recently it occurred to him that, together 
with Screenly, it would make the perfect home-brew digital 
photo frame and another great Raspberry Pi-based hardware 
project. In this tutorial, we will show you how to assemble this 
powerful hardware/software combination for yourself. 


^*1 Order your items 

%#l If you haven’t already got them 
in your Raspberry Pi collection, you will 
need to order all of the items from the 
“What you'll need” list. The HDMIPi is 
currently only compatible with Model B 
of the Raspberry Pi, although a Model 
B+ version is in the works (the B+ 
does actually work with HDMIPi, but 
unfortunately cannot fit into the case). 
Pretty much any USB keyboard will 
work with Screenly, including wireless 
ones, so you do not need to worry about 
a mouse for this tutorial as it will all be 
done from the command line. 

Finally, a speaker is only necessary 
if you intend to play videos from the 
display with sound as well. 
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MAKE A DIGITAL PHOTO FRAME 



f\f% Assemble your HDMIPi 

The HDMIPi comes as a do-it-yourself kit rather than 
a polished product. Not only does this make it cheaper for you 
to buy, but it also gives it a more hack-like feel in its Pibow- 
esque acrylic layer case, it is not hard to assemble, but in 
case you get stuck there is a fantastic assembly video here: 
http://hdmipi.com/instructfons. 



Download Screen lyOSE 

\#0 Now that you have the hardware all ready to go we need 
to download the Screenly OSE SD card image. This is only a 3.7GB 
image file, however it may not fit on some 4GB SD cards so we 
would recommend a minimum of 8GB, for extra space for all your 
pictures and videos. Visit bitly/lwLKIRQand download the ZIP file 
from one of the mirrors under the “Getting started" heading. 


M Flash image to SD Card (Linux) 

it’s worth noting the value of having a Linux machine 
at your disposal (or a spare Raspberry Pi and SD card reader) 
to download the ZIP file in Step 03. This is typically the easiest 
way to unzip the file and copy the image across to your SD 
card. Assuming the disk isn’t mounted, open a terminal 
session and type: 


| unzip -p /path/to/sc reenly_image.zip 
bs-lM of=/dev/sdX 


sudo dd 


Make sure that you replace /path/to/screenlyjmage.zip with 
the actual path. 



AP Flash image to SD Card (Other OS) 

If you do not have another Linux machine handy, or 
a card reader for your Raspberry Pi, you can still do this from 
other popular operating systems. On Windows you should use 
Win32 Disk Imager and follow the easy to use GUI. From Mac 
OS X you have the options of using the GUI-based software 
packages PiWriter and Pi Filler, or running some code from the 
command line. Visit www.screenlyapp.com/setup.html for 
more info. 

A/ Insert SD card and peripherals 

Once the Screenly image has been successfully 
transferred to your SD card, you will need to insert it into the 
Raspberry Pi within your HDMIPi casing. 

It is a good idea to connect your Wi-Fi dongle and keyboard 
at this point. Take a look at the image at the top of this 
page to see where the slots are in relation to the casing. A 
wired network is also required for the initial setup and for 
configuring the Wi--i connection. 


Boot up your Raspberry Pi 

w The HDMIPi driver board has a power output for the 
Raspberry Pi which means you onLy need one power supply for 
this setup. Plug it in and wait for it to boot into the Screenly splash 
screen. An IP address (of format http://aaa.bbb.ccc.ddd:8080) 
should be displayed here, which will allow you to gain access to the 
management dashboard. 


Above The reverse 
view of HDMIPi, 
showirtgGPIOand 
connector cutouts 


History of 
HDMIPi 



HDMIPi isa 
collaboration 
between Cyntech 
and Alex Eames 
from RasPi.TV. They 
wanted to bring a 
cheap HD resolution 
HDMI screen to the 
market that will 
reduce the cost of 
havinga dedicated 
monitor for your 
Raspberry Pi. They 
tooktoKickstarter 
to launch their idea 
(kck,st/17zyaQg) 
and there was a huge 
response to this 
project from both 
within and outside 
the Raspberry Pi 
community. Over 
2,500 people from 
all over the world 
enabled them to 
smash their £55,000 
target, and the 
campaign finished 
with over £260,000. 
UNICEF even 
thought they were 
good enough to use 
in their educational 
projects in Lebanon 
(bit.ly/ZDp08Z), 
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HARDWARE 



Above Screen Ly Pro 
can manage multiple 
screens and has 
cloud storage too 


O-Sfc 


Schedule Overview 




■Hr 


ttlMl 





3n this tutorial we 


have used the open 
source version 
of Screenly- 
Screenly OSE. This 
is a fantastic bit 
of software and a 
great addition to 
the open source 
ecosystem. At this 
point, someof you 
may be dreaming 
of huge remote- 
managed display 
screen networks 
and the good news 
isthatthisisentireLy 
possible with 
Screenly Pro. This 
is completely free 
fora single display 
screen and 2GB of 
storage, and it has 
larger packages for 
purchase starting 
at two screens right 
up to 130+ screens. 
It also adds a lot of 
additional features 
not seen in Screenly 
OSE -find out more 
about those on the 
Screenly website 
(biUy/1 EXI92p), 


Disable Screenly video output 

Load the IP displayed on the splash screen on the 
browser of a different computer (you won’t be able to do it 
directly from the same Pi). The Screenly OSE dashboard should 
now load. Once inside the dashboard, move the slider for Big 
Buck Bunny to the OFF position or delete the asset entirely. 

AQ Enter the command line 

Once you have disabled the Big Buck Bunny 
trailer from the web interface, you should now be able 
to enter the command line easily and you can do this by 
pressing Ctrl+Alt+FI on the attached keyboard at any 
time. Alternatively, you can access the command line 
over SSFi using the same IP address as shown previously 
on the splash screen. 


Run th^updctte script 

l\# The image file we downloaded from the website is 
actually just a snapshot release and does not necessarily 
include the latest Screenly OSE code, as the code updates 
are made more regularly than the image, it is therefore 
good practice to run an upgrade to the latest version using the 
built-in script. You can run the following command: 

| -/screen ly /mi sc/runjjpgrade.sh 


YY Configure Raspberry Pi 

I I Once you are successfully at the command line, you need 
to type sudo raspi-configto enterthe settings and then select 
‘1 Expand root file system’ to make sure you have access to all of 
the space on the SD card. Then, change the time zone (option 4 
and then 12) so that it is correct for your location. If your screen 
has black borders around the edge you may also need to disable 
overscan (option 8 and then A1). We would also recommend 
changing the default password to something other than 
raspberry to stop any would-be hackers from easily accessing 
the Raspberry Pi via SSFI (option 2). Once complete, exit without 
restarting by selecting Finish and then No. 


Y#Y Enable and set up Wi-Fi 

\^m As Screenly runs on top of Raspbian, the Wi-Fi setup 
is essentially the same as the standard command line 
setup within the OS. In order to do this you need to edit the 
interfaces file using sudo nano /etc/network/interfaces 
and then type in the following code, replacing ssid and 
password with the actual values: 

| auto lo 

| iface lo inet loopback 
iface eth0 inet dhcp 

| allow-hotplug wlan0 
| auto wlan0 

( iface wlan0 inet dhcp 
| wpa-ssid “ssid” 

| wpa-psk “password” 

| iface default inet dhcp 


Then exit and save by hitting Ctrl+X, then Y and then Return. 
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MAKE A DIGITAL PHOTO FRAME 



B Test the connection 

The easiest way to test the Wi-Fi connection is to shut 
down the Raspberry Pi using sudo shutdown -h nowand then 
remove the wired network connection and reboot the Raspberry 
Pi by removing and reattaching the microUSB power connector. If 
the Wi-Fi connection has worked, you should now see the splash 
screen with IP address again. 



M Upload pictures to Screenly 

Once again, you will need to visit the Screenly OSE web 
interface by entering the IP address into another computer. 
Since you are now using a wireless connection, the IP address 
may be different to the previous one. You need to select the 
‘Add Asset' option at the top right-hand side, which should 
launch a pop-up options screen. Select Image from the drop- 
down box and you then have the option of either uploading the 
image or grabbing it from a URL using the corresponding tabs. 
Enter the start date and end date of when this image should 
appear, and how long it shou ld appear on screen for, then press 
Save. Repeat this step for each of the pictures. 


Above Once fully configured, load 
your pictures and video to complete your 
digital photo frame! 

T C Test with video and more 

Pictures are great, but Screenly also allows you to display 
videos (with audio if you wish) and web pages, which really is a 
huge benefit. This is perfect if you want to enhance your digital 
photo frame even further or perhaps display the local weather 
and news to keep yourself informed. Plug in your speaker - we 
would recommend The Pi Hut portable mini speaker (available 
from bit.ly/lxEpBNZ) or anything similar. 

Place in situ and enjoy! 

IU Once you have got Screenly all set up and loaded all of 
your favourite pictures and videos onto it via the web interface, 
it is now time to enjoy the fruits of your labour! Mould the spider 
stand (if you have one) into shape by taking the middle two legs 
at the top and bending them downwards and backwards. Then 
spread the front-middle legs a bit wider to give a good base and 
shape the outer legs at the top and bottom to support the screen. 
You are then ready to give it its permanent home - our expert’s is 
on the mantelpiece over the fireplace! 

F Other project ideas 

In this tutorial we have looked at just one fairly basic 
application of Screenly and the HDMIPi, You could use this 
powerful open source software to run your digital signage empire, 
share screens in schools and clubs, or as a personal dashboard 
usings suitable web page. Whatever you make, please don’t forget 
to take pictures and send them to us! 


Access 
Screenly 
from afar 



The default Screenly 
image is essentially 
some additional 
software running 
on top of Raspbian 
OS. This means that 
SSH is enabled by 
defauLt{it T swhy we 
changed the default 
password in Step 11} 
so it’s now possible 
toaccessthe 
command line, as 
well as the Screenly 
dashboard, from 
outside of your LAN. 
We recommend 
setting a static IP 
for your Screenly- 
powered Raspi 
from your router 
settings and then 
setting up SSH with 
keys on your PL and 
port forwarding 
on your router 
for ports 22 and 
8080. The Screenly 
dashboard has no 
login so anyone 
can access it, but 
an authentication 
feature is imminent, 
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HARDWARE 



Clip-on The attachment dips on 

to your regular prescription glasses or 
sunglasses, so you don’t have to worry 
about sacrificing your ability to see 



Video display The tiny screen 

on top of your glasses provides a 320 by 
240 display and feels like you’re looking 
at a 52-Ench screen a few feet away 


Casing ALithe components taken 
from the original video glasses have 
been rewired and then sealed in this 
eight-piece, 3D-prlnted enclosure 


Power If you want to use Pi Glass 
on the go then plug it into a portable 
USB battery pack. The Ruiz brothers 
mounted it onto a belt: bitiy/1 HDjlyS 


Components list 

Raspberry Pi Model B 
NTSC/PAL video glasses 
Miniature wireless USB 
keyboard with touchpad 
USB battery pack 
3D printer 
CAD files (.stl) 

Composite video cable 
30AWG wire wrap 
Heat shrink pack 




The Pi Glass attachment is affixed 
to your regular glasses usingthe small 
clip on the Inside of the central block 

These video glasses cost about 
$110/£70and, while not exactly suited 
for long-term use t they’re perfect fo r 
repurposing into other optical projects 
like the Pi Glass 
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HOW I MADE: PI GLASS 



How did you get started with Adafruit? 

It was about a year ago, we 
came on their show-and-tell and we 
wanted to show people what projects 
we were working on. At the time it was a 
simple wearable project - a 3D-printed 
belt buckle with Adafruit LEDs and 
their GEMMA microcontroller, so the 
thing there is mixing self-expression 
and design with the electronics and 
making it flashy and cool. Adafruit liked 
that, and what they liked even better 
is that we make videos as well, so Phil 
[Torrone], a cofounder of Adafruit, 
wrote to us asking if we’d like to be 
an author on their Adafruit Learning 
System. We said sure, we can write 
documentation, but we can also do 
video. And that led to starting another 
project and it gained momentum from 
there, and every week we’ve been 
coming out with a new 3D-printed 
project since. Recently it’s been getting 
much bigger, and it’s always a challenge 
because every week we’re upping our 
skills - it’s like, can we design that, 
will that print? So far it’s been more 
successes than failures. We do a good 
job learning from the bad stuff and 
capturing the really good stuff and 
telling people in our guides how to keep 
moving on. It’s very hard stuff but we try 
to make it look like it’s not so hard so 
that peopLetry it out and learn from it. 
We try to make the guides as 
repeatable as we can - step-by-step 
guides that are easy to use. 

It’s so open sourcey! We had no idea 
of the open source hardware movement 
and it’s completely empowering to give 
away our design files. When we started 
out as Pixil 3D we really didn’t give away 
our designs - we’d hold on to them 
because it was our stuff. But now it 
makes so much sense to give them away 
since you have that incentive to. It’s like 
hey, here’s a cool project idea - just buy 
some parts and then follow along with 
our circuit diagrams and tutorials. 

It really speaks to what 3D printing 
is becoming; it’s the shell that holds all 
the components that bring itto life. 


So what exactly does you r DIY Glass do? 

The idea was sort of inspired 
by Limor [Fried] herself - she has 
these hundred-dollar video glasses 
on the shop and she said; “You know 
what? Let’s take it apart. Let's take 
the guts out, the actual circuitry, and 
make a new format for it. Instead of 
being two glasses let’s make it clip 
on to your existing glasses kinda like 
Google Glass, but let’s make it for the 
Raspberry Pi." So that was the original 
idea and it was rather simple because 
there really wasn’t much programming 
or software involved - it was just 
repurposing this component inside 
this hundred-dollar pair of glasses 
and making it more Google Glassy and 
more DIY. From a design standpoint 
it was really challenging because the 
tolerances and things for that was 
kinda hard, especially for different 
machines - you’re always looking at 
different tolerances; even when you’re 
slicing it, things will come out a little 
bit differently. So that’s why it’s so 
important to give away the files and to 
tell people that you can modify it and 
you can make it work for you. And quite 
a few people have made their own and 
printed it for their application. 

It’s a good foundation for anybody 
who can build on top of it. So we’ve 
seen different Pi Uls that mimic the 
Google Glass Ul -- this is something that 
somebody could take and sort of adapt. 

It’s a great example - so someone 
who’s not super ace at designing or 
printing but maybe has the software 
chops can take this project and make it 
even better. We’d really like to see that. 

How did you make the attachment after 
you split up the original video glasses? 

So I guess for starters we bust out 
the calipers and we start measuring 
like crazy. From there we designed the 
components, we remake them in CAD 
- our favourite CAD right now is 123D 
Design, which is from Autodesk. We 
use it literally on a daily basis. But you 
start off by making the components 


and modelling them out, and creating 
the enclosure on top of that and just 
chiselling away and creating features, 
figuring out how to split it up into pieces 
so that it can print without any support 
material. We really strive to make our 
designs with no supports - that way you 
can get a really clean design that looks 
beautiful and doesn’t require that extra 
bit of waste. And it is 3D printing - it’s 
rapid, right? So we prototype the piss out 
of our projects! We’re so fortunate that 
we have the time to do it. It’s hard to keep 
it under two weeks, but it really feels like 
it’s a rush and we do step back and take 
thetimeto make sure it’s right. 

We always have a buffer of at least 
a month with projects already in the 
works and we make sure we keep the 
pipeline full - sort of like a TV schedule. 
And sometimes if we can’t finish quite 
in time, we let people know and say hey, 
you can finish this for us by all means - 
go ahead and pick up where we left off. 

How is the Pi talking to the attachment? 

It’s just plugged in through HDMI, 
really - it’s just an add-on to the Pi 
to make it mobile. You just plug into a 
battery bank, so in that respect it’s really 
quite simple. 

Is there an easy way to controlthe output? 

We have a small wireless keyboard 
that we sell in the shop, so we thought 
we’d keep it as simple as possible and 
use that to control things on the Pi. 

Do you thinkthis is a project you’ll revisit? 

With the release of the A+ we 
might revisit it. Build more libraries for 
talking to sensors and things like that 

Maybe something more enclosed 
and more specific to the Pi. We have 
a really cool remote team that does 
different projects as well, so we’re 
just now starting to collaborate with 
them because they’re more skilled and 
disciplined in software engineering, so 
it’s really cool to bring those two minds 
together - the design and videography 
and then the software engineering. 



has designed 
products for several 
different industries 
since the age of 14, 
in creative mediums 
including Ul design 
foriOS apps, 
websites and also 
audio production for 
video games 





has been a media 
designersince 
1999. He’s worked 
on a wide range of 
projects including 
iPhone apps, video 
games, 3D modeling, 
video production 
and social media 
content 


If you want to make 
your own Pi Glass 
then checkout Noe 
and Pedro’s tutorial 
on the Adafruit 
LearningSystem: 
bit.ty/lfbHhfw 


To see some of the 
crazy electronic 
costumes and 
3D-printed gadgets 
that the Ruiz 
brothers make, 
check out their main 
page over at the 
Adafruit site: 
bit.ly/lyBSECn 


61 




Create a full-functional. Pi-powered games console that you can 
play Minecraft on and learn how to program too 

Minecraft means many things to many people, 
and to Raspberry Pi users it’s supposed to mean 
~ P education. Not everyone knows, though, that you 
can still have fun and play Minecraft as you normally would. 

Using Raspberry Pi, it is also the cheapest way to get 
a fully-functional version of Minecraft up onto your TV. 

However, in its normal state, just being on a TV isn’t the end of 
it. Using all the features and functions of the Pi, we can take 
it to a state more fitting of a TV by making it into a hackable, 
moddable Minecraft console. 

In this tutorial, we will show you how to set it up in terms of 
both software and hardware, how to add a game controller to 
make it a bit better for TV use, and we’ll even give you some 
example code on how to mod it. Now, it’s time to get building, 
so head to Step 1, 


WhatyouH need 

Raspberry Pi 2 
i Latest Raspbian image 

raspberrypi.org/downloads 

■ Minecraft Pi Edition 

pi.minecraft.net 

Raspberry Pi case 

■ USB game controller 
{PS 3 preferable) 
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BUILD A RASPBERRY PI MINECRAFT CONSOLE 



Choose your Raspberry Pi 

\# I Before we start anything, everything we plan 
to do in this tutorial will work on all Raspberry Pi 
Model Bs with at least 512 MB of RAM. However, Minecraft: Pi 
Edition can chug a little on the original ModeL Bs, so we suggest 
getting a Raspberry Pi 2 to get the most out of this tutorial. 
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Prepare your Raspberry Pi 

\3^m Minecraft: Pi Edition currently works on Raspbian. We 
recommend you install a fresh version of Raspbian, but if you 
already have an SDcard with it on, the very least you should do is: 

| sudo apt-get update && sudo apt-get upgrade 

f | Prepare Minecraft 

tf you’ve installed Raspbian from scratch, Minecraft 
is actually already installed - go to the Menu and look under 
Games to find it there ready, if you’ve just updated your version of 
Raspbian, you can install it from the repos with: 


| $ sudo apt-get install minecraft- 


Pi 


M Test it out 

If you’ve had to install Minecraft, it’s best just to check 
that it works first. Launch the desktop, if you’re not already in 
it, with startx and start Minecraft from the Menu. Minecraft: 
Pi Edition is quite limited in what it lets you do, but it does make 
room for modding. 

AJT X setup 

\#%# If you have a fresh Raspbian install and/or you have 
your install launch into the command line, you need to set it to 
load into the desktop. If you’re still in the desktop, open up the 
terminal and type in raspi-conf ig. Go to Enable Boot to Desktop 
and choose Desktop. 


Above Give 
Minecraft: Pi Edition 
a quick test before 
you start building 
the console 


If you’ve installed Raspbian from 
scratch, Minecraft is actually 
already installed - go to the Menu 
and look under Games to find it 


A/ Setup Python 

While we’re doing set up bits, we might as well modify 
Mincecraft using Python for a later part of the tutorial. Open up 
the terminal and use: 

| $ cp /opt/minecraft-pi/api/python/mcpi -/minecraft/ 

Minecraft at startup 

For this to work as a console, we’ll need it to launch into 
Minecraft when it turns on. We can make it autostart by going 
into the terminal and opening the autostart options by typing: 

| $ sudo nano /etc/xdg/lxsession/LXDE-pi/autostart 

AQ Autostart language 

In here, you just need to add @minecraft-pi on the 
bottom line, save it and reboot to make sure it works. This is a 
good thing to know if you also want other programs to launch as 
part of the boot-up process. 

Turnoff 

For now, we can use the mouse and keyboard to shut 
down the Pi in the normal way, but in the future you’ll have to start 
turning it off by physically removing power. As long as you’ve exited 
the Minecraft wo rid and saved, that should be fine. 


Updates to 
Pi Edition? 


Minecraft: Pi Edition 
hasn't received an 
update for a little 
while, but itwas 
previously limited by 
the original Model 
B. Now with more 
power, there may 
bean update that 
adds more to it, but 
right now there ! s no 
indication of that. If 
it does come though, 
all you need to do is 
update your Pi with: 
sudo apt-get u pdate 
&& sudo apt-get 
upgrade. 







Getting power to the Raspberry Pi 2 
so that it runs properly can be tricky if 
you’re using a USB port 



3D-print 

3 C8S6 



Aaron Hicks at 
Solid Technologies 
designed this 
Minecraftoase for 
the Raspberry Pi 
and shared it on 
GrabCAD, We've 
uploaded our slightly 
modified version to 
FileSUoxo.uk along 
withyourtutorial 
fiLes for this issue. 

All you need to do is 
send the STL file to 
a 3D printing service 
-many high street 
printing shops have 
at least a MakerBot 
these days -and 
they will 3D-print 
the case for you, 
it should only cost 
around £15. 



The correct case 

In this scenario, we're hooking this Raspberry Pi up to a 
TV, which means it needs a case so that there’s less chance of 
damage to the components from dust or static. There are many 
good cases you can get - we are using the Pimoroni Pibow here 
as you can mount it to the back of the TV. Alternatively, you could 
get really creative and 3D-print your own case, as you can see on 
page 58. Check out the boxout just to the left. 

Find the right power supply 

Getting power to the Raspberry Pi 2 so that it runs properly 
can be tricky if you’re using a USB port or a mobile phone charger 
- the former will be underpowered and the latter is not always 
powerful enough. Make sure you get a 2A supply, like the official 
Raspberry Pi one. 


Go wireless 

We understand that not everyone has an ethernet cable 
near their TV, so it may be a good idea to invest in a Wi-Fi adapter 
instead. There is a great list of compatible Wi-Fi adapters on the 
eLinux wiki: elinux.org/RPLVerifiedPeripherals. 

Mouse and keyboard 

Now that we have the Raspberry Pi ready to be hooked up, 
you should look at your controller situation - do you want to be 
limited by the wires or should you get a wireless solution instead? 
We will cover controller solutions over the page, but it’s worth 
considering now. 

Get ready for SSH 

It will be easier to create and apply scripts to Minecraft 
by uploading them via the network rather than doing it straight 
on the Pi. In the terminal, find out what the IP address is by using 
ifconfig, and then you can access the Pi in the terminal of another 
networked computer using the followi ng: 

| ssh pi@[IP address] 

Have a play 

At this stage, what we have built is a fully-functional 
Minecraft console. Now, at this point you could start playing if 
you so wish and you don’t need to add a controller. You can flip 
over to page 62 now if you want to begin learning howto mod your 
Minecraft and do a bit more with it to suit your needs. However, 
if you do want to add controller support then carry on and take a 
look at Step 1 6. 
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BUILD A RASPBERRY PI MINECRAFT CONSOLE 



L2 Right click (hit) 
LI Cycle held item 


Start 

Escape 


PS Button 
Connect 
controller 


Select 

Escape 


Directional 

buttons 

Movement 


Controls 


Here's the fuLL 
Layout of the 
buttons used 
by the PS3 
controller by 
defauLt-youcan 
change them in 
the script that you 
download inStep 18 


L3/R3 
Descend 
while flying 


Left stick 
Movement 


Right stick 
Camera 


R2 Right dick (hit) 


R1 Cycle held item 


A Inventory 


O Escape 


Jump 


Inventory 



y # Add controller support 

1^/ Make sure the controller input functions are installed 
on the Raspberry Pi. To do this, ssh into the Raspberry Pi like 
we did in Step 14 (where ‘raspberry’ is the password) and install 
the following package: 

| $ sudo apt-get install xserver-xorg-input-joystick 

F Controller mapping 

We have a controller map for the PS3 controller that 
you can download straight to your Pi, and with a bit of tweaking 
can fit most USB controllers as well. Go to the controller 
configuration folder with: 

| $ cd /usr/share/Xll/xorg.conf.d/ 



lO Re^oottouse 

17 After a reboot to make sure everything’s working, you 
should be able to control the mouse input on the console. R2 and 
L2 are the normal mouse clicks and can be used to navigate the 
Minecraft menu to access the game. 



Xbox 

controllers 


Unfortunately, Xbox 
360 controllers work 
slightly differently 
with Linux. As they 
use their own drivers 
that are separate 
to the normal 
joystick drivers we 
used for the PS3 
pad and other USB 
controllers, a 360 
controller doesn’t 
work as a mo use and 
isharderto assign 
specific functions to. 
This makes it tricky 
to use in a situation 
such as this. 


Replace the controller mapping 

We’ll remove the current joystick controls by using sudo 
rm 50-joystick. conf and then replace by downloading a 

custom configuration using: 

| $ sudo wget http://www.linuxuser.co.uk/wp-content/ 
uploads/2015/04/50-joystick.conf 


Go full-screen 

So far you may have noticed that Minecraft is running 
in a window - you can click the full-screen button to make it fill 
the screen, however you then heavily limit your mouse control. 
Thanks to the controller, you can get around that. As soon as you 
load the game, make sure you use the sticks for movement and 
the d-pad for selecting items in the inventory. 








HARDWARE 


Mod your Minecraft 

Here is some example code, and explanations for it, so that you can 
leam how to program in Python and mod Minecraft Pi 



We program Minecraft to react in python using the 
API that comes with Minecraft: Pi Edition - it’s what 
we moved to the home folder earlier on. Now’s a 
good time to test it - we can do this remotely via SSH. Just cd 
into the Minecraft folder in the home directory we made, and 
use nanotest.py to create ourtest file. Add the following: 


from mcpi. minecraft import Minecraft 
from mcpi import block 
from mcpi.vec3 import Vec3 
me = Minecraft. create() 
me .postToChat(“Hello, Minecraft ! ”) 


Save it, and then run it with: 

| $ python test.py 

“Hello, Minecraft!" should pop up on-screen. The code imports 
the Minecraft function from the files we moved earlier, which 
allows us to actually use Python to interact with Minecraft 
along with the various other functions and modules 
imported. We then create the me instance that will allow us 
to actually post to Minecraft using the postToChat function. 
There are many ways you can interact with Minecraft in this 
way - placing blocks that follow the player, creating entire 


structures and giving them random properties as they’re 
spawned as well. There are very few limits to what you can do 
with the Python code, and you can check out more projects 
here: https://mcpipy.wordpress.com. 

Over the page, we have a full Listing for a hide and seek 
game that expands on the kind of code we’re using here, 
where the player must find a diamond hidden in the level, with 
the game telLing you whether you’re hotter or colder. You can 
write it out from scratch or download it to your Pi using the 
following commands: 

| $ wget http://www.linuxuser.co.uk/tutorialfiles/ 

Issuel34/ProgramMinecraf tPi . zip 
| $ unzip ProgramMinecraftPi.zip 

| $ cp Programs MinecraftPi/hide_and_Seek.py '/minecraft 

Check out the annotations to the right to see how it works. 

I We program Minecraft to react in 
Python using the API that comes with 
Minecraft Pi - it’s what we moved to 
the home folder earlier 
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Import 

Here we’re import ingthe necessary modules 
and APIs to program Minecraft Most 
importantly are the files in the mcpi folder 
that we copied earlier 


Full code listing 

from mcpi. minecraft import Minecraft 
from mcpi import block 
from mcpi.vec3 import Vec3 
from time import sleep, time 
import random, math 


Locate 

We connect to Minecra ft with the first line, 
and then we find the player’s position and 
round it up to an integer 


me - Mi nec raft* create () 

playerPos = me . player . getPos 0 

def roundVec (vec3): 

Vec3(int(vec3.x) , int(vec3.y), int(vec3.z)) 


Range finding 

Calculate the distance between the player 
and diamond. This is done in intervals Later 
on in the code, and just compares the co- 
ordinates of the positions together 


i iF (pointl, point2) : 

xd = point2.x - pointl. x 
yd = point2.y - pointl. y 
zd = point2.z - pointl. z 

math . sqrt ( (xd*xd) + (yd*yd) + (zd*zd)) 


Creation 

Create a random position for the diamond 
within 50 blocks of the player position that 
was found earlier 


Start 


randorrLblockO: 

randomBlockPos = roundVec3 (playerPos) 

randomBlockPos . x = random. randrange( randomBlockPos. x - 50, randomBlockPos . x + 56} 
randomBlockPos . y = random. randrange( randomBlockPos. y - 5, randomBlockPos . y + 5) 
randomBlockPos . z - random. randrange( randomBlockPos. z - 50, randomBlockPos . z + 56) 
randomBlockPos 


This is the main loop that actually starts the 
game. It asks to get the position of the player 
to start each loop 


Notification 

This part sets the block in the environment 
and pushes a message using postToChat to 
the Minecraft instance to let the player know 
that the mini-game has started 


f raainO: 

lastPlayerPos , playerPos 
seeking = True 
lastPlayerPos = playerPos 

randomBlockPos = random_block() 

me . setBlock( randomBlockPos , block . DIAM0ND_BL0CK) 

mc.postToChaf(“A diamond has been hidden - go find!”) 


Checking 1 

We start timingthe player with timeStarted , 
and set the last distance between the player 
and the block. Now we begin the massive 
while loop that checks the distance between 
the changing player position and the fixed 
diamond, if the player is within two blocks of 
the diamond, it means they have found the 
block and it ends the loop 

L 


Message writing 

If you’re two or more blocks away from the 
diamond, it wiLL tellyou whether you’re nearer 
or farther away than your last position check. 
It does this by comparing the last and new 
position distance - if it’s the same, a quirk in 
Python means it says you’re colder. Once it’s 
done this, it saves your current position as 
the Last position 


Success 

It takes a two-second break before updating 
the next position using the sleep function. If 
the Loop has been broken, it tallies up your 
time and lets you know how long it was before 
you found the diamond. Finally, the last bit 
then tells Python to start the script at 
the mainfunction 


lastDistanceFroirBlock = distanceBetweenPoints (randomBlockPos, lastPlayerPos) 
timeStarted = time() 
seeking : 

playerPos = mc.player.getPos() 
if lastPlayerPos != playerPos: 

distanceFroirBlock = distanceBetweenPoints (randomBlockPos, playerPos) 
if distanceFromBlock < 2: 
seeking - False 


distanceFromBlock < lastDistanceFronfilock: 

me. postToChat (“Warmer ” + str(int (distanceFromBlock)) + “ blocks away”) 
distanceFromBlock > lastDistanceFronfilock: 

me. postToChat (“Colder ” + str(int(distanceFromBlock)) + “ blocks away”) 
lastDistanceFronfilock = distanceFromBlock 


sleep(2) 


timeTaken = time() - timeStarted 

me. postToChat (“Well done - ” + str(int (timeTaken)) + “ seconds to find the diamond”) 

name — “ main 

mainQ 
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Camera 48 Raspberry Pi 

Cameras make up Bullet Pi, with each 
one sitting in the lower half of each 
piece of the frame composingthe ring 


Frame While the shots for 

each set of BulLet Pi images can be 
adjusted, they're kept leveL with a 
custom Laser-cut frame 


King Bullet Pi uses a ring setup so 
that you can rotate around a subject 
frozen in time once the photos are 
stitched together 


Pi Face The Control and Display 
module has an LED screen for two 
16-character lines, five control buttons, 
a navigation switch and IR receiver 


Cables About haLf a kilometer 
of network cable was used to build 
Bullet Pi “the Pi Face modules were a 
godsend during debugging 
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Components list 

if* 48 Raspberry Pi Model Bs 

■ 48 Raspberry Pi Cameras 
9 48 PiFace Control and 

Display modules 

■ 48 NOOBS SD cards 
■48 5V PSUs 

■ 500m of network cable 

■ 2 x 24 port switches 
Wireless router 


Many people wondered 
if Andrew and the team were 
building a Large Hadron Collider 
when the first few photos were 
teased online 

Liz Upton, head of 
communications at the 
Raspberry Pi Foundation, tests 
out Bullet Pi at the Manchester 
Raspberry Jam in 2013 










What inspired you to create Bullet Pi? 

So I’d seen The Matrix and also a BBC 

programme called Supernatural: The 
Unseen Powers Of Animals, where they 
shot dolphins jumping out of the water, 
froze time, and then spun around so you 
saw the water drops, and I thought that 
was a really amazing effect. And reading 
how it was done, it was with a whole 
array of cameras and it seemed quite 
simple. So I had the Raspberry Pi and a 
couple of cameras sat on my desk, and 
it was sort of like, ‘Well, if it seems that 
simple, then surely if we just got a whole 
load of Raspberry Pis and cameras - 
and they’re not that expensive - why 
shouldn’t we just be able to build it?’ 
It was one of those moments where 
you think it should work but you don’t 
actually know. So what I did was buy 
four cameras and I tried it, and that 
looked like it would work - it gave us a 
tantalising glimpse that we could do it. 

So itwasagood concepttest? 

Yeah, but even so it wasn’t conclusive - 
it just told us that it’s possibly likely but 
we still didn’t actually know. So then it 
was just a case of buying a few more 
cameras. You get to the stage where 
all you can think is, ‘Right, let’s go for it. 
Let’s have a full set of 48 cameras and 
just build it.’ It was only really when we 
got the first set of images out, and then 
stitched that together, that you could 
see having a whole load of cameras and 
firing them at once is pretty much all we 
needed. It was one of those things where 
‘Wouldn’t it be cool if,..?’ became ‘You 
know, we might be able to...’ and then 
‘Oh, we’ve done this!’ 

That’s where the best Pi projects come 
from! So how do you set it off? 

It’s gone through a few iterations and, 
as we’ve tried it, we’ve made a few 
refinements. In the latest setup, we’ve 
got all the Pis booted into Raspbian and, 
on boot, they run a little Python script 
we’ve got. We’ve fitted them so every Pi’s 
got a PiFace Control and Display module 
that you can have simple interactions 


HOW I MADE: BULLET PI 



with using buttons - it just drives a 
menu. So that lets us know that all the 
Pis have booted up, because if you’ve 
got 48 Pis and a network cable comes 
out, it’s tricky to find out which one 
when they all look the same. So that was 
really just a luxury in terms of helping 
to debug, and It also means we can 
reconfigure the array if we wanted to do 
a lateral version. 

What are you using to stitch the images? 

That’s FFmpeg. We’ve had to do some 
things with the alignment just to get a 
smooth video out, because some of the 
cameras are at slightly different angles 
and if you don’t then the picture tends 
to go up and down. Basically we take 
a set of images with each calibration 
and work out whether there’s a positive 
or negative offset to each frame, then 
when we stitch them together we chop 
off the top and the bottom and just use 
the middle of the frame. 

Is that handled by a script or do you do it 
man ualLy once you've taken the shots? 

We actually trigger it as two points, but 
there’s nothing to stop the two scripts 
being put together in the command 
line and all being run at once. The only 
reason we run it twice is that the script 
to stitch the images together takes 
about a minute and sometimes, if you 
take an image and then the person 
you’re taking the image of says ‘I don’t 
like that, let’s do it again’, it saves 
cancelling something that’s already 
started. So for logical reasons we 
run it as two separate operations but 
effectively they’re just two commands: 
one command to take the images and 
one command to stitch the images, 
and there’s nothing to stop it all being 
automated. You could put a pressure 


pad in there so that when people stood 
in the middle of the bullet rig it would 
automatically trigger. 

Is the PiFace a crucial component or was 
it just something you wanted to use? 

It was a luxury for us that we had it 
kicking around. It turned out to save us 
time when we were debugging. It’s not 
essential - you can build it without - but 
it made life much easier. We’ve also tried 
it in other configurations, and when you 
put it in other configurations, just being 
able to go through a menu on each Pi 
and then set where it is in the sequence 
is a lot easier if you can actually relate to 
the Pi that you’ve got in your hand, rather 
than having to look at what number it is, 
SSH into it and set a file. 

What configurations have you tried? 

We tried semicircles and we’ve tried 
straight lines, and that way you get the 
effect of the camera panning along as 
opposed to spinning around a point. 
We’ve got future plans, which involve 
taking it into more wild and wacky 
situations. So far we’ve learned from 
the examples we’ve done inside, and 
then as we’ve got the setup faster 
and more automated and got all the 
little tweaks and experiences from it, 
we’re becoming more ambitious with 
it. There are definite plans to mount it 
on impressive things outside and get 
some sports photography going with 
it. There’s one person who actually 
booked us for their wedding after they’d 
seen it - they wanted photographs of 
their guests and it would be different, 
something unusual to capture the 
guests in a 360-degree spin. That’s the 
other nice thing about it - community. 
You put something online and suddenly 
it goes off in a different direction. 


We’ve got future plans, which 
involve taking it into more wild and 


wacky situations 



Jk 


is an honorary 
research fellow of 
the University of 
Manchester, and the 
creator of PiFace 
Control and Display 
(learn more at 
piface.org.uk) 


If you’re thinking 
of using PiFace 
Control and Display 
in one of your own 
projects, check 
out the excellent 
tutorials provided 
by the team over 
at: piface.org.uk/ 
guides 


To see Bullet Pi in 
action, checkout 
this video from 
its first outing at 
the Manchester 
Raspberry Jam in 
2013: biUy/1wloP6y 
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Supercharge your Pi 

Get the most out of your Raspberry Pi 


Create your own digital 
assistant port 1 

Tell your computer what to do 




Create your own digital 
assistant port 2 

Continue this project by decoding audio 


create your own aigitai 

assistant port 3 

Run the commands you're giving your Pi 


Run science experiments 
on the Expeyes kit 

Make use of this digital oscilloscope 

Monitor CPU temperature 
with Dizmo 

Access the Internet of Things 

Forecast the weather with 
your Raspberry Pi 

Prepare yourself for the next big storm 

Print wirelessly with your 
Raspberry Pi 

Breathe new life into an old printer 

Remotely control your 
Raspberry Pi 

Employ your Pi as a media centre 

Turn your Pi into a motion 
sensor with SimpleCV 

Implement facial recognition into your Pi 

Code a simple synthesiser 

Write a simple synthesiser using Python 


Set up a 
motion sensor 


II 

k S- 

1 




Create a 
gital assistant 


Use your Rasp! 
out your coding 


Raspberry Pi 
Ddina skills c 


3 i to test 
and get 


I 


to grips with programming" 


Print documents 
wirelessly 
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SOFTWARE 






Your Raspberry Pi is plugged in, Raspbian is installed on 
the SD card and you are right in the middle of setting up a 
wireless print server or building a robot to collect your mail 
from your doormat. 

But are you truly getting the most from your little 
computer? Do the components you’re using maximise the 
potential of your Raspberry Pi or are they holding it back? 
Perhaps you haven’t explored the full set of options in 
Raspbian, or you’re running the entire OS from SD card, 
somethingthatcan reduce SD card lifespan. 

Various tools and techniques can be employed to 
improve performance, from choosing the right hardware 
to overclocking the CPU. You might even maximise storage 
space on the Raspberry Pi’s SD card or all but replace it with a 
secondary device to help improve speed. 

Use these tips and tricks to reconfigure your Raspberry Pi 
setup and optimise software and hardware to ensure you get 
the best performance for your projects. 


yith these 



Use better storage hardware 

Your choice of storage media can have an impact on your 
Raspberry Pi’s performance, regardless of the operating system. 
A low capacity SD card with poor error correction, is going to be 
slower than a larger card with greater resilience, so you need to 
find the right balance for your project and shop wisely. 








SUPERCHARGE YOUR RASPBERRY PI 



Choosing the bestSD card 

Various standards of SD card are available, with the 
more expensive designed for better error correction. For the best 
performance on your Raspberry Pi, choose an SDHC card with a 
high rating. The same advice applies to MicroSD cards, which you 
can use on your Raspberry Pi with an SD card adaptor or directly 
insert into a Raspberry Pi B+. 



Make the most of your storage 

You’ll typically need 1-2GB of storage for your chosen 
Raspberry Pi distro, so any remaining storage on your SD card will 
be used for updates and data you create or save. 

In Raspbian you can open a command line and run the 
configuration utility to gain more space (only if your SD card’s 
greaterthan2GB): 


sudo raspi-config 


' d 



Expand the Raspbian partition 

Maximising the partition affords the full capacity of 
your SD card, which will increase the media’s lifespan (there 
is more space to write too, so the same sectors aren’t being 
overwritten as often). 

With raspi-config running, use the arrow keys to select 
expand_rootfs in the menu. Then wait briefly while the 
partition is resized. 


0 Write data to RAM 

Rather than reading and writing data to your SD card 
- something that will eventually result in a deterioration of 
reliability and performance - you can configure Raspbian to 
write to the system RAM, which will speed things up slightly 
and improve SD card performance. 

This is achieved using fstab (file systems table), a system 
configuration available in most Linux distros. 


There’s a 
great guide to SO 
cards at elinux.org/ 
RPi_SD_cards 



Enable fstab in Raspbian 

uu This is much like creating a RAM disk in Windows and 
is almost as easy to setup. In the command line, enter; 


sudo nano /etc/fstab 

Add the following line to mount a virtual file system: 

tmpfs /var/log tmpfs defaults,noatime,nosuid,mode= 
0755, size=l 00m 0 0 

Follow this by saving and exiting nano (Ctrl+X), then safely 
restartingthe Pi: 

sudo shutdown -r now 


Buy rated 
SD cards 



ft’s all too tempting 
to boot up your 
Raspberry Pi with 
an image copied to 
an SD card that you 
just pu Lied out of 
your DSLR or phone. 
After all, they’re alt 
the same, right? 

The chances are 
that your chosen SD 
card was one that 
you had lying about 
when you bought 
your Raspberry PL 
It might be good 
enough but if you 
want the best 
performance, a high- 
rated SDHC card 
with plenty of space 
is recommended. 
Such media is 
inexpensive and can 
be bought online or 
in supermarkets. 
Just make sure 
you’re buying a 
known brand! 












Havingyour 
filesystem on a USB 
stick is great for 
backups as well as 
performance boosts 


Picking an 
external 
USB drive 



Speeding up your 
Raspberry Pi by 
migratingtheroot 
filesystem to an 
external USB drive 
is a start, but what 
sort of de vi ce sh ou Ld 
you use for the best 
performance? With 
a USB thumb drive 
you can add flash 
storage up to 16 
GB without running 
into any significant 
problems (the 
Larger the drive, the 
greater the cu rrent 
is required to read/ 
write)- Anything 
Larger is expensive 
and unnecessary. 

If you’re planningto 
use an external HDD, 
there are no power 
issues as it will 
have its own power 
supply. As ever, your 
choice shouLd suit 
your project. 


Configure fstab for fast performance 

Upon restarting, the virtual file system will be 
mounted and /var/log on the RAM disk. Other directories that 
can be moved to RAM include: 

tmpfs /tmp tmpfs defaults, noatime, nosuid,size=100m 0 0 
tinpfs /var/tmp tmpfs defaults, noatime, nosu id ,size=30 
m 0 0 

tmpfs /var/log tmpfs defaults, noatime,nosuid,tTiode=0755, 
size=100m 0 0 

tmpfs /var/run tmpfs defaults, noatime, nosuid,mode=0755 
,size=2m 0 0 

tmpfs /var/spool/mqueue tmpfs defaults,noatime,nosuid,m 
ode=0700,gid=12,size=30m 0 0 

Add each to /etc/fstab in nano. 

MoveyourOStoaHDD 

If you’re concerned about the lifespan of the SD card, 
why not reduce your Raspberry Pi's reliance on it? Instead of 
using the SD card as a sort of budget SSD, change its role and 
add a HDD or USB stick to run the operating system, leavmgthe 
SD card for bootstrapping. This can give a marked performance 
boost to the SD card. 


Copy Raspbian to USB 

Using a blank Ext4-forrnatted USB thumb drive (or 
external HDD) as the destination drive, enter: 

sudo dd bs=4M if=~/backup . img of=/dev/sdc 

Leave the backup on your computer, just in case something 
goes wrong. With an SD card and USB storage device sharing 
an identical disk image, it’s time to consider what you’re going 
to do next - create afaster Raspberry Pi. 





Back up the SD card 

Begin by creating a copy of your Raspberry Pi’s SD card. 
Shut down, remove the card and insert it into your desktop 
computer. In the command line, run: 

sudo dd bs-4M if=/dev/sdb of-~/backup.img 

The path /dev/sdb represents the SD card. Copy ing should take 
5-10 mi nutes. When complete, remove the SDcard and connect 
your USB device. 


Split the Raspbian partitions 

I I Ideally, the boot partition should remain on the SD card 
white the root filesystem is run from the external HDD or USB 
thumb drive. Using your preferred partition manager (Disk Utility 
is in most bistros), unmount and delete the root filesystem from 
the SD card, ensuringyou have retained the boot partition. After 
removing the SD card, connect your USB device and delete the 
boot partition, taking care to leave the root filesystem intact. 
Then resize the root filesystem on the USB device, making sure 
that 10 MB remains. 
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Identify the root filesystem 

With this configuration you’re going to have the SD card 
and the external USB storage connected, so you need to tell 
the Pi where the root filesystem is. Still on the desktop Linux 
computer with your SD card inserted, run: 

sudo nano /boot/cmdline.txt 


Boost performance with overclocking 

Need more from your Raspberry Pi? It is possible to 
overclock the computer, although you should be aware of the 
risks inherent with this activity. You should also ensure that 
your Raspberry Pi’s processor is suitably cooled - heatsinks 
for the CPU, Ethernet controller and power regulator can be 
purchased online. 



Heatsinks 
for the Pi are widely 
available and usually 
cost less than $10 


Find root=/dev/mmcblk0p2 (or similar) and change that to 
read root=/dev/sda2 which is your external USB storage. Save 
and exit. 


1*3 Add other USB devices 

You can now restart your Pi with the storage devices 
attached, but as soon as you connect further USB media 
you’ll suffer problems. Avoid this by installing gdisk: 


sudo apt-get update 
sudo apt-get install gdisk 


Then run gdisk: 

sudo gdisk /dev/sdb 

Enter ? to display the options and select Recovery and 
Transformation options (experts only), followed by Load MBR 
and Build Fresh GPT. Tap ? one last time and select ‘Write 
Table to Disk’ and exit. Remove and replace the USB device 
and run gdisk again. This time enter I and then 1 to display the 
Partition Unique GUID. 

M Make your Pi fast & reliable 

Make a note of the GUID and then switch to the SD 
card. Reopen cmdlme.txt and change root=/dev/mmcblk0p2 
to root=PARTUUID=XXXXXX, where the numerical string from 
the partition unique GUID should replace the XXXXXX. When 
you’re done, save and exit. You can then start your Raspberry 
Pi. Congratulations, your Raspberry Pi is now faster and more 
reliable to use! 



Overclock your Raspberry Pi 

Overclocking is available through raspi-config. Launch 
from the command line and arrow down to the overclock 
option. Four further options are available: Modest, Medium, 
High and Turbo. With your ideal clock speed selected, exit 
raspi-config and restart your Raspberry Pi to apply: 

sudo shutdown -r now 

Now you will need to perform tests to see how stable it is 
overclocked. Raspberry Pi founder, Eben Upton, suggests 
running Quake 3 as a good stress test. Should the Pi fail to 
boot, hold Shift to boot without overclocking, run raspi-config 
and select a more modest overclock. 


Run Raspbian without the GUI 

Despite these changes, you may find that the GUI 
remains slow. If you find yourself running a lot of commands in 
bash, the best thing to do is disable launching into X. In raspi- 
config, choose boot_behaviour and select the first (default) 
option to ensure your Pi boots to the command line. Should 
you need the GUI, enter ‘startx’ in Terminal. 


OvercLock 
with a 
heatsink 


Overdocking 
is potentially 
dangerous to 
any computer 
system, which is 
why it’s great that 
the Raspberry Pi 
developers have 
included the facility 
in their approved 
ope rating system 
and allowed its use 
under warranty. If 
you’re using this 
feature, heatsinks 
and water cooling 
systems are 
available forthe 
Raspberry Pi to 
ensure you don’t 
bake the CPU and 
RAM when in use. 
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SOFTWARE 


Voice 

control 

In this and further 
issues, we will 
look at the parts 
needed to make your 
own voice control 
software for your 
projects . If you want 
a virtual assistant, 
one project is the 
Jasper system 
(jasperproject. 
githu!bJo).The 
documentation on 
the main website 
has a description of 
hardware to attach 
to your Raspberry 
Pi and a full set of 
instructions for 
installation and 
configuration. There 
is a set of standard 
modules included to 
alio w i nte ract i o n w it h 
various services. 

Use the time, Gmail 
or even the joke 
module, and there 
are also third-party 
modules foryou to 
access. There is even 
a developer API an d 
documentation to 
help you add your 
own functionality 
to Jasper. 


Check outthe 
documentation to 
see what Jaspercan 
do; biUy/1MCdDh4 


Create your own 

digital assistant part 1 


Everyone who has watched the Iron 
Man movies has probably dreamt of 
having their own artificially intelligent 
computer system to do their every 
bid and call. While Jarvis has massive 
amounts of computing power behind him, 
you can construct the front-end with very 
modest resources. With a Raspberry Pi 
and the Python programming language, 
you can build your own personal digital 
assistant that can be used as a front-end 
to whatever massive supercomputing 
resources that you use in your day-to-day 
life as a playboy, philanthropist genius. 
We will go over the basics that you will 
need to know over the next few pages, so 
that by the end of the series you should 
be able to build your own rudimentary, 
customised agent. 

The first step to interacting with the 
humans around us is to listen for verbal 
commands so that we know what we 
need to process. You have several options 
available to handle this task. To keep 
things simple, we will be dealing only with 
devices that are plugged into one of the 
USB ports. With that stipulation you can 
talk directly with the USB device at the 


lowest level. This might be necessary if 
you are trying to use something that is 
rather unusual to do the listening, but 
you will probably be better off using 
something that is a bit more common. In 
this case you can use the Python module 
PyAudio. PyAudio provides a Python 
wrapper around the low level cross- 
platform library PortAudio. Assuming that 
you are using something like Raspbian for 
your distribution, you can easily install the 
required software with the command: 

sudo apt-get install python- 

pyaudio 

If you need the latest version you can 
always grab and build it from source. 
PyAudio provides functionality to both 
read in audio data from a microphone, 
along with the ability to play audio data 
out to headphones or speakers. So we will 
use it as our main form of interaction with 
the computer. 

The first step is to be able to read 
in some audio commands from the 
humans who happen to be nearby. You 
will need to import the ‘pyaudio’ module 


before you can start interacting with the 
microphone. The way PyAudio works is 
similar to working with files, so it should 
seem familiar to most programmers. 
You start by creating a new PyAudio 
object with the statement p = pyaudio. 
PyAudioO. You can then open an input 
stream with the function p.openC..), with 
several parameters. You can set the data 
format for the recording: in the example 
code we used format=pyaudio.palnt16. 
You can set the rate in Hertz for sampling. 
For example, we are using rate=44100, 
which is the standard 44.1 KHz sampling 
rate. You also need to say how big a 
buffer to use for the recording - we 
used frames. per_buffer=1 024. Since 
we want to record, you will need to use 
mput=true. The last parameter is to 
select the number of channels to record 
on, in this case we will use channels=2. 
Now that the stream has been opened, 
you can start to read from it. You will 
need to read the audio data in using the 
same chunk size that you used when 
you created the stream - it will look like 
stream. read(1024). You can then simply 
loop and read until you are done. There 
are then two commands to shutdown the 
input stream. You need to call stream. 
stop_stream() and then stream.closeO. If 
you are completely done, you can now call 
p.terminateQ to shutdown the connection 
to the audio devices on your Raspberry Pi. 

The next step is to be able to send 
audio output so that Jarvis can talk to 
you as well. For this you can use PyAudio, 
so we won’t have to look at another 
Python module. To make things simple, 
let’s say that you have a WAVE file that 
you want to play. You can use the ‘wave’ 
Python module to load it. Once again, you 
will create a PyAudio object and open a 
stream. The parameter ‘output’ should 
be set to true. The format, the number of 
channels and the rate is all information 
that will be derived from the audio data 
stored in your WAVE file. To actually hear 
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FORMAT pyaudio palntl6 
CHANNELS = 2 
RATE = 44100 
RECORD_SECS = 5 


p pyaudio PyAudio() 


stream 


p open(format= FORMAT, c 

rate=RATE, input 


lannel 

TRUE, 


s- CHANNELS, 

f rames_per_buff e r=CHUNK) 


frames = [] 

for i it range (0, int(RATE CHUNK * RECORD_SECS) ) : 
data = stream read (CHUNK) 
frames append (data) 


stream stop_stream() 
stream close () 
p terminate () 


wave 


wf wave open (“filename wav”, “rb”) 


p pyaudio PyAudioQ 


stream p open(format=p get_format_from_width(wf getsampwidthQ) , 

channels wf getnchannels(), rate wf getf ramerate() , 

output=True) 


data = wf readframes (CHUNK) 
while data ‘ ’ : 

stream write (data) 

data wf readframes (CHUNK) 


stream stop_stream() 
stream close () 
p terminate () 


the audio you can simply loop through, 
reading one chunk of data from the WAVE 
file at a time and immediately writing out 
to the PyAudio stream. Once you’re done 
you can stop the stream and close it, as 
you did above. 

In both of the above cases, the 
functions block when you call them 
until they have completed. What are 
the options if you want still be able 
to do processing while you are either 
recording audio or outputting audio? 
There are non-blocking versions that 
take a callback function as an extra 
parameter called strearri_callback. This 
callback function takes four parameters, 
named in.data, frame_count, time., info, 
and status. The in_data parameter will 
contain the recorded audio if input is 
true. The callback function needs to 
return a tuple with the values out_data 
and flag. Out_data contains the data to 
be outputted if output is true in the call 
to the function open. I the input is true 
instead, then out_data should be equal to 
None. The flag can be any of paContinue, 
paComplete or paAbort, with obvious 
meanings. One thing to be aware of is that 
you cannot call, read or write functions 
when you wish to use a callback function. 
Once the stream is opened, you simply 
call the function stream. start_stream(). 
This starts a separate thread to handle 
this stream processing. You can use 
stream. is_ activeO to check on the current 
status. Once the stream processing is 
done, you can call stream. stop_stream() 
to stop the secondary thread. 

Now that we have covered how to get 
audio information into and out of your 
Raspberry Pi, you can start by adding this 
functionality to your next project. In the 
next step, we will look at how to convert 
this audio information into something 
usable by the computer by using voice 
recognition modules. We will also look at 
the different ways to turn text into audio 
output using TTS modules. 
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Offload 

tasks 

You can offload 
the audio data 
processingto 
Google, accessing 
the API directly over 
HTTP by posting 
your audio data to 
the appropriate 
URL. First install 
the Python module 
SpeechRecognition: 

pip install 
Spe ec h Re cogn it i o n 

Now create an 
instance of the 
Recognizer object. 

A Helper object, 
called WavFile, will 
take an audio file 
and prepare it for 
use by the Google 
APLThen process 
itwiththerecordO 
function and hand 
this processed audio 
in to the function 
recognize{). When 
it returns, you will 
get a list of pairs of 
possible texts, along 
with a percentage 
confidence level for 
each possible text 
decoding. Be aware 
that this module uses 
an unofficial API key 
to do its decoding, 
so for anything mo re 
than small personal 
testingyou should 
request your own 
API key. 


F t CMUSphinx 
is used in cross- 
platform, open 
source projects like 
I LA, the Intelligent 
Learning Assistant 





Previously we looked at how we could 
have our Raspberry Pis listen to the 
world around them. This is the first 

step in building our own version of the 
J.A.R.V. .S system made famous in the 
Iron Man movies. The next step is to try 
and make sense of what we may have 
just heard. In general, this is called 
speech recognition and it is a very large 
and active area of research. Every major 
mobile phone operating system has 
applications trying to take advantage 
of this mode of human interaction. 
There are also several different Python 
modules available that can do this 
speech-to-text (STT) translation step. In 
this second article, we will look at using 
Pocket Sphinx to do all the heavy lifting. 
Sphinx was developed by Carnegie 
Mellon University and is licensed under 
a BSD licence, so you are free to add 
any extra functionality that you may 
need for specific tasks. Because of the 
activity in this field, it is well worth your 
time to keep track of all the updates and 
performance improvements. 

While you can download the source 


all from scratch, we are going to assume 
that you are using one of the Debian- 
based distributions, like Raspbian. For 
these you can simply use: 

sudo apt-get install python- 
pocket sphinx 

...to get all of the required files for the 
engine. You will also need audio model 
files and language model files in order 
to get a translation in you language of 
choice. To get the files needed for English, 
you can install the packages: 

sudo apt-get install pocketsphinx- 
hmm-wsjl pockets phinx-lm-wsj 

You may need to go outside the regular 
package management system if you want 
to process other languages. Then you 
can simply start writing and using your 
code straight away. To start using these 
modules, you will need to import both 
pocketsphinx and sphinxbase with: 


These modules are actually Python 
wrappers around the C code that 
handles the actual computational work 
of translating sounds to text. The most 
basic workflow involves instantiating a 
Decoder object from the pocketsphinx 
module. The Decoder object takes several 
input parameters to define the language 
files it is allowed to use. These include 
'hmm’, ‘lm’ and 'diet’. I : you use the above 
packages used to handle English, then 
the files you need will be in the directories 
/usr/share/pocketsphinx/model/hmrn/ 
wsjl and /usr/share/pocketsphinx/ 
model/lm/wsj. If you don’t set these 
parameters, then it tries to use sensible 
defaults which usually work fine for 
English language speech. This newly 
created Decoder object can now be given 
WAV files with data to process. If you 
remember that previously, we saved the 
recorded speech as a WAV file. In order 
to have this audio recorded in the correct 
format, you will want to edit the code from 
the first tutorial and ensure that you are 
recording in mono (using one channel, for 
example), and recording at 16kHz with 16- 
bit quality. To read it properly you can use 
a file object and load it as a binary file with 
read permissions. WAV files have a small 
piece of header data at the beginning of 
the file that you need to jump over. This 
is done by using the seek function to 
jump over the first 44 bytes. Now that 
the file pointer is in the correct position, 
you can hand the file object in to the 
Decoder object’s decode_raw() function. 
It will then go off and do a bunch of data 
crunching to try and figure what was 
said. To get the results, you would use the 
get_hyp() function call. You get a list with 
three elements from this function: a string 
containing the best guess at the spoken 
text, a string containing the utterance ID 
and a number containing the score for 
this guess. 

So far, we’ve looked at how to use the 
generic language and audio models 


code for all of these modules and build it 


pocketphinx ps 
sphinxbase 


HeylLA how are you' 1 



Search the web, get 
directions, set a timer ... 




Good thank /ou 



Ok, ok just give me 
second ... © 






L ASSISTANT, PART 2: SPEECH RECOGNITION 



g -U 


for a particular language. But Pocket 
Sphinx is a research -level language 
system, so it has tools available to 
enable you to build your own models. 
In this way, you can train your code to 
understand your particular voice with 
all of its peculiarities and accents. This 
is a long process, so most people will 
not be interested in doing something so 
intensive. However, if you are interested, 
there is information available at the main 
website (cmusphinx.sourceforge.net). 
You can also define your own models and 
grammars to tell pocketsphinx how to 
interpret the audio that it is processing. 
Once again, effectively carrying out 
these tasks will require more in depth 
reading on your part. 

If you want to process audio more 
directly, you can tell Pocket Sphinx to 
start processing with the function start. 
utt(), You can then start reading audio 
from your microphone. You will want to 
read in appropriate sized blocks of data 
before handing it in to pocketsphinx 
- specifically to the function process. 
raw() - and you will still need to use the 
function get_hyp() to actually get the 
translated text. Also, because your code 
can’t know when someone has finished 
a compLete utterance, you will need 
to do this from within a loop. On each 
pass of the loop, read another chunk 
of audio and feed it into pocketsphinx. 
You then need to call get_hyp() again to 
see if you can get anything intelligible 
from the data. When you are done doing 
this real-time processing, you can use 
the function end_utt(). 

So far, we have covered how to record 
your speech and how to turn that speech 
into text. In the next tutorial, you will 
learn how to take that translated speech 
and actually take actions based on 
how the system has been configured. 
But even with only these two steps, 
you could build yourself a nifty little 
dictaphone or vocal note-taking system. 


Full code listin 



in or pocketsphinx ps 
import sphinxbase 


) I I 


. I J 


hmmd = Vusr/share/pocketsphinx/model/hmm/wsjl’ 

lmd = ‘ /usr/share/pocketsphinx/lm/wsj/wlist5o. 3e-7. vp. tg. lm. DMP’ 

dictd Vusr/share/pocketsphinx/lm/wsj/wlist5o.dic’ 

d ps. Decode r(hmm hmmd, lm=lmd, diet dictd) 


wavFile (' my_file.wav’ , ‘rb’) 

wavFile. seek(4^ ) 


d. decode.r aw (wavFile) 
results d.get_hyp() 


decoded_speech = results [ 0 ] 

prin “I said decoded.speech[0], “ with a confidence of ”, decoded.speech [ 1 ] 


i&C0Qj.rt£f. you fiSt 


IN IL/k 


t pyaudio 
p pyaudio. PyAudioQ 


II I JU 




in.stream p.open( ormat pyaudio. palntl6, channels-1, rate= 16000, 

input=True, frames_per_buffer=1024) 
in.stream. start_stream() 


d.start_utt() 
while True: 

buf = in_stream. read ( 1324 ) 
d.process„raw(buf , False, False) 
results = d,get_hyp() 


vou 


)U 


cl i 


Sr 


r 


d.endjjttQ 


r 'i 
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Digital assistant, part 3: 
run other programs 



Social 

media 




You may want your 
system to check 
your social media 
accounts on the 
Internet. There are 
several Python 
modules available 
to handle this. Let’s 
say that you want to 
be able to check your 
Facebook account. 
Install the following 
Python module: 

sudo apt-get 
install python- 
face book 

You can then use 
import facebook to 

get access to the 
Facebook APL If 
you’re a Twitter user, 
install the python- 
twitter Debian 
package to use the 
Twitter API. Email 
is easier as long as 
your email provider 
offers IMAP or POP 
access. You can then 
import emails and 
get voice control to 
read unread emails 
out to you. For the 
Google fans, Google 
has a Python module 
that provides access 
to the APIs for 
almost everything 
available; work with 
your calendar, email 
or fitness data. 


This is the last in our trilogy of articles 
to help you build your own voice control 
system. The first article looked at how 
to listen for incoming commands. This 
involved listening on a USB device and 
also outputting audio feedback to a 
user. The second article looked at how to 
interpret those commands. This involved 
using speech recognition libraries to 
translate the recorded audio into text that 
can be processed. This time, we will look 
at how to actually run the commands that 
were given. We will look at a few different 
options to execute tasks and get work 
done based on the interpreted speech. 

If you have put together a system 
based on the suggestions from the first 
two articles, you should have a string 
containing the text that was spoken to 
your Raspberry Pi. But, you need to figure 
out what command this maps to. One 
method is to do a search for keywords. 


tf you have a list of keywords available, 
you can loop through them and search 
the heard string to see if any one of those 
keywords exist within it as a substring. 
Then you can execute the associated task 
with that keyword. However, this method 
wilL only find the first match. What 
happens if your user accidentally includes 
a keyword in their spoken command 
before the actual command word? This 
is the auditory equivalent to having fat 
fingers and mistyping a command on the 
keyboard. Being able to deal with these 


errors gracefully is an ongoing area of 
research. Maybe you can create a new 
algorithm to handle these situations? 

Let’s say that you have a series of 
Python scripts that contain the various 
tasks you want your system to be able 
to tackle. You need a way to have your 
system be able to run these scripts when 
called upon. The most direct way to run 
a script is to use execfile. Say you have 
a script called do_task.py that contains 
Python code you want to run when a 
command is given; you can run it with: 

execfile(“do_task.py”) 

Using this form, you can add command 
line options to the string being handed 
in. This will look in the current directory 
for the script of that file name and run it 
in the current execution context of your 
main program. If you need to rerun this 


code multiple times, call execfile each 
time you do. If you don’t need the script 
to run within the same context, use the 
subprocess module. Import it with: 

im; subprocess 

You can then execute the script like so: 

subprocess, call(“do_task.py”) 

This will fork off a subprocess of the 
main Python interpreter and run the 


script there. If your script needs to 
interact with the main program, this 
is probably not the method that you 
should use. Collecting output from a 
call to do_task.py with subprocess 
isn’t straightforward, so another way 
of achieving the same thing is to use 
the import statement. It also runs the 
code in your script at the point the 
import statement is called. If your 
script only contains executable Python 
statements, these get run at the point of 
importation. In order to rerun this code, 
you need to use the reload command. 
The reload command doesn’t exist in 
version three - so if you’re using that 
particular Python version, a better 
option is to encapsulate the code 
contained in the script within a function. 
You can then import the script at the 
beginning of your main program and 
simply call the relevant function at 
the correct time. This is a much more 
Pythonic method to use. If you have the 
following contents for do.task.py; 

. do_f'unc(): 

do_taskl() 

do_task2() 

You can then use it with the following 
code within your main program: 

import do_task 

* * * -a 
9 9 * 

do_task,do_func() 

r f i i 

An even more Pythonic method is to use 
classes and objects. You can write a script 
that defines a class that contains methods 
for you to call when you need it. 

What are the options if you want 
to do something that isn’t achievable 
with a Python script? In these cases, 
you need to be able to run arbitrary 
programs on the host system. The host 


A more Pythonic method is to 
use classes and objects. You 
can write a script that defines 
a class that contains methods 
for you to call when you need it 






OTHER PROGRAMS 



system in this case is your Raspberry 
Pi. As a toy example, let us say you 
need to download some emails using 
the Fetchmail program. You can do 
this in a couple of different ways. The 
older method is to use the os.systemQ 
command where you hand in a string. In 
our example, this would look something 
like the following: 


do_task.py 


in< (): 

"Hello World 


tf 


main_program.py 


os . system (“/u sr/bi n/f etchmail”) 

You need to explicitly use os.wait() to be 
told exactly when the task has finished. 
This method is now being replaced by 
the newer subprocess module. It gives 
you more control over how the task gets 
run and how you can interact with it. A 
simple equivalent to the above command 
would look like this: 

subprocess. call(“/usr/bin/ 
fetchmail”) 

It waits until, the called program has 
finished and returns the return code to 
your main Python process. But what if 
your external program needs to feed 
in results to your main program? In 
this case, you can use the command: 
subprocess.check_output(). This is 
essentially the same as subprocess. 
call(), except when it finishes, anything 
written out by the external program to 
stdout gets handed in as a string object. 
If you also need information written out 
on stderr, you can add the parameter 
stderr=subprocess.STDOUT to your call 
to subprocess.check_output. 

After reading these three articles, you 
should have enough of the bare bones 
to be able to build your own version of 
the J.A.R.V.I.S system. You will be able 
to fine-tune it to do basically anything 
that you command it to do. So go forth 
and order your machines around, and 
have them actually listen to what you are 
saying for once. 


do_task 


do_task . do_f unc () 


os 


returncode = os.system(“/usr/bin/fetchmail”) 


subprocess 


returncode = subprocess. call (“/usr/bin/f etchmail”) 


returned„data = subprocess. check_output(“/usr/bln/fetchmail”) 



Left TheJasper 
project has some 
great documentation 
that might help guide 
you further in terms 
of hardware and 
software choices 
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WhcrtyouH need 

Raspberry Pi Model B 
ExpEYES kit 



ExpEYES is a relatively unheard of but very impressive 
hardware and software platform for science and 
electronics experimentation, as well as a useful electronic 
probing tool for makers and professionals alike. It is also 
open source on both the hardware and software sides, which 
makes it affordable and versatile. 

ExpEYES is billed as a science and experimentation kit 
but really it is much more than that - it is a fully-functioning 
four-channel digital oscilloscope with an impressive 
array of features. ExpEYES ships with a wealth of online 
documentation in a variety of formats (graphics, user 
guides, web content), including upwards of 50 suggested 
experiments, and the kit itself contains all of the hardware 
required to play with the interesting science of electronics 
contained within the guide material. 

The aim is to enable the learning of what can be complex 
concepts of electronics in an easy and affordable way, 
without getting bogged down in the arcane details. Paired 
with our favourite little single-board computer, the Raspberry 
Pi, you have an extremely powerful and affordable device. 



Get the parts 

ExpEYES is available to purchase from a variety of online 
vendors, including CPC (http://cpc.farnell.com), for around £50. 
It is possible to get the kits slightly cheaper from India or China 
(see bit.ly/1H38EFC for other vendors worldwide), however it's 
likely to end up costing more due to higher shipping rates as well 
as potential import fees and duties. 
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RUN SCIENCE EXPERIMENTS ON THE EXPEYES KIT 



The kit itself 
is highly portable 
and great for taking 
down to Jams and 
backspaces 


( Vrt Open it up 

wm The ExpEYES kit contains everything you need to get 
underway, with over 50 documented experiments from the 
ExpEYES website. The only other item that may come in handy 
is a breadboard. You will also need a Raspberry Pi or other 
computer with a USB port in orderto run the digital oscilloscope 
software and connect to ExpEYES. 



0% What’s inside? 

o As you may have guessed, the ExpEYES kit includes 
the main ExpEYES USB digital oscilloscope, but it also contains 
a wide range of other hardware including a DC motor, magnets, 
LEDs, coils, piezoelectric discs, wiring, a small screwdriver for 
opening the screw terminals and more. You also get a live CD 
which contains all the ExpEYES software and documentation 
ready to go on a bootable disc. 

f\A What can it do? 

The chip at the heart of ExpEYES is an AVR ATmegaIG 
MCU (microcontroller unit), running at 8 MHz coupled to a USB 
interface 1C (FT232RL). These are low-cost but provide good 
value for money. As we have already mentioned, ExpEYES is 
therefore capable of acting as a four-channel oscilloscope but 
also has a built-in signal generator, 12-bit analogue resolution, 
microsecond timing resolution and a 250 kHz sampling 
frequency. At this price point, that's an impressive set of features 
and certainly accurate enough for anything that is not mission 
critical (like learning, hobby projects, quick readings and soon). 



It pays dividends to make sure that 
your operating system is updated to 
the latest stable version, as this can 
save you a lot of hassle 



UsingtheliveCD 

Perhaps the easiest way to get up and running with 
ExpEYES (if you have a computer with a CD drive) is to use the 
live CD which is included in the ExpEYES kit. Making sure that 
you are booting into the live CD from your BIOS boot menu, you 
should then be greeted with a Linux-based desktop. Plug in your 
ExpEYES by USB and you can open the software from the menu 
by going to Applications>Science>ExpEYES-Jumor. Alternatively, 
you can run it from a terminal window using: 

sudo python /u s r/sha re/ex peye s/eye s-j u n i o r/c ro p lu s . py 

a Update your Raspberry Pi 

As with almost every project you undertake on the 
Raspberry Pi, it pays dividends to make sure that your operating 
system is updated to the latest stable version, as this can save 
you a lot of hassle further down the line. To do this, open an 
LXTerminal session and then type sudo apt-get update, followed 
by sudo apt-get upgrade -y, and then wait patiently for the 
upgrade process to complete. 


Other 

supported 

platforms 

The ExpEYES 
software is mainly 
written in Python, 
This means that the 
core soft ware to 
run your ExpEYES 
device is quite 
platform-agnostic - 
if the device can run 
a Python interpreter 
and has a Python 
module enabling it 
to access the serial 
port then it will work 
with ExpEYES. If you 
visit the ExpEYES 
website, there is a 
page that explains 
how to install the 
software on Linux 
and Windows - 
www.expeyes. 
in/software- 
installation, In 
addition, there is a 
native Android app 
which will enable 
your ExpEYES 
to work with any 
Android device that 
has USB QTG (on the 
go) capability. 
















i SOFTWARE 


Exp EYES 
& PHOENIX 


ExpEYES was 
developed by Ajith 
Kumarand his 
team as part of the 
PHOENIX (Physics 
with Homemade 
Equipment 
and Innovative 
Experiments) 
project, which was 
started In 2005 as a 
part of the outreach 
program of the 
Inter-University 
Accelerator Centre 
(IUAC)in New Delhi, 
India, Its 
objectives are 
developing 
affordable 
laboratory 
equipment and 
training teachers to 
use it in their 
lesson plans, 



Install the software 

Due to efforts of community member Georges 
Khaznadar, there are DEB packages available for the ExpEYES 
software that should work perfectly on Debian, Ubuntu, Linux 
Mint and, of course, Raspbian. These are also included in the 
official Raspbian repositories, so all you need to do to install 
the ExpEYES software is to open an LXTerminal session on the 
Raspberry Pi and then run the following commands: 

sudo apt-get update 

sudo apt-get install expeyes 


Install dependencies 

ExpEYES has a number of dependencies that are 
required for it to run under Linux, as well as a number of other 
recommended libraries. During the installation undertaken 
in Step 7, the dependencies should be installed by default. 
However, to avoid any problems later, you can run the following 
command in orderto make sure thatthey are all installed: 

sudo apt-get install python python-expeyes python- 
imaging-tk python-tk grace tix python-numpy python- 
scipy python-pygrace 



Overclock your Raspberry Pi (optional) 

The ExpEYES software will run fine on a Raspberry Pi 
with default settings, however it can be slow to respond if you 
are using a Model A, B or B+. We recommend using a Model 2B, 
but if you don’t have one, overclocking your Pi would be advisable 
(you can overclockyour 2B as well if you want it to run a bit faster). 
Open an LXTerminal session and type sudo raspi-config. in the 
menu, select the option ‘7 Overclock’. Click OK on the following 
screen and then select Turbo. Click OK and you should see some 
code run. Once this completes, press OK again and then you are 
brought back to the main raspi-config window. Select Finish in 
the bottom right and Yes to reboot your Raspberry Pi. 



Fqi recovery mode, hoW I tt Shift 1 


Overclocking continued 

Overclock can sometimes cause instability on your 
Raspberry Pi or an inability to boot at all. If this happens you can 
press and hold the Shift key on your keyboard once you reachthe 
above spLash screen to boot into recovery mode. You can then 
redo Step 7 at a lower overclock setting and repeat until you find 
the highest stable setting. 

Resistance of the human body 

An interesting experiment for your first time using an 
oscilloscope it to measure the resistance of the human body over 
time. This is easy to accomplish with just three bits of wire and a 
resistor (200 kOhm). On the ExpEYES, connect a wire between 
A1 and PVS, connect the resistor between A2 and ground, and 
connect an open-ended wire out of both PVS and A2. Plug in your 
ExpEYES and open the control panel, then drag A1 to CHI and 
A2to CH2, and set PVS to 4 volts. You can then pick up one of the 
open-ended wires in each hand and watch the response on the 
ExpEYES control panel. 

Run the maths 

From the output plot, you should find that the input on 
CHI is coming out at 3.999 volts (which is great because we set 
it to be 4!). The voltage on A2 (CH2) is showing as 0.9 volts for 
us, which implies that the voltage across the unknown resistor 
value (your body) is 4 - 0.9 = 3.1 volts. Using Ohm’s law (V=IR), 
we can then calculate the current (I) across the known resistor 
value: voltage e resistance - 0,9 e 200,000 = 0,0000045 amps 
= 4.5 uA (micro amps). Using this value we can then calculate 
the resistance of the body using the same Ohm’s law equation in 
reverse: voltage -r current = 3.1 -r 0.0000045 = 688889 ohms = 
689 kQ. This is a surpisingly high value, however the resistance 
of the human body depends hugely on how dry your skin is and 
a large number of other factors (body resistance is usually in the 
range of 1 ,000 to 1 00,000 ohms). 

Use the Python library 

The ExpEYES team have built a custom Python library 
for the device. This is slightly harder to use than the GUI and 
not as pretty, but it enables a lot more versatility as well as the 
capability to use ExpEYES functionality within your Python 
scripts. !f you have folLowed the installation instructions above, 
all you need to do is import the Python module and then initialise 
aconnectiontothe ExpEYES using: 

import expeyes. eyes j 
p-expeyes.eyesj ,open() 
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RUN SCIENCE EXPERIMENTS ON THE EXPEYES KIT 



There’s a great range of 
experiments for you to try inside 
the ExpEYES documentation over 

atibit.Ly/lE7hdYy 


A digital storage oscilloscope is 
a useful tool in any engineer or 
hacker’s toolbox, as it enables you 
to get insights into your projects that 
aren’t possible with visual checks 


The Python library (continued) 

Now we will plot a sine wave using the ExpEYES and 
PyLab libraries. On the device, connect OD1 to INI and SINE to A1 
with some wire. Run the following code and you should see that a 
sign wave has been plotted, 

import expeyes.eyesj 
from pylab import * 

p-expeyes. eyes j. ope n() 
p. set _state (10,1) 
print p.set_voltage(2.5) 
ion() 

t,v = p. capture (1,300,100) 

(plot t,v) 


Further experiments 

P This tutorial has shown you just a single example of 
the documented ExpEYES experiments available at http:// 
expeyes.in. There is a wide variety of different techniques 
and phenomena explored in those experiments, so it is highly 
recommended to get your hands on an ExpEYES kit and work 
through them. Running through those examples as a beginner 
will give you a much deeper understanding of electronics. 

The verdict 

A digital storage oscilloscope (plus extras) is a useful 
tool in any engineer or hacker’s toolbox, as it enables you to get 
insights into your projects that aren’t possible with just visual 
checks or using a multimeter. Whilst no £50 oscilloscope will 
compare to expensive professional units, this is a great entry- 
level product as well as a versatile, portable USB device with 
multiplatform support for when you just can't be lugging around 
a 10 kg, £1000+ scope. 
















SOFTWARE 




The Raspberry Pi is an exciting 
prospect for people interested in an 
internet of Things - size, power and 
flexibility make it perfect for powering 
any Internet-connected device 
around the home or office. Setting up 
a Raspberry Pi to be the brain of an loT 
network isn't exactly a case of selecting 
the right software in Raspbian, though; 
there’s a lot of custom work you need to 
do to get one going. 

This is where Dizmo comes in, 
enabling you to control loT objects 
using an online API that you can then 
access remotely. To show you how it 
works, we’re going to have it track the 
Raspberry Pi’s core temperature. In this 
tutorial we are going to work entirely 
over SSH, but you can easily do this 
straight on the Pi - the benefit of SSH 
though is that for a real loT, it will be 
easier to maintain remotely. 



Dialintoyour Pi 

Make sure your Raspberry Pi can connect to your 
network, either via Wi-Fi or ethernet cable, and find out the 
IP address by using ifconfig. Use this IP to dial into the Pi from 
another system with: 

$ ssh pi@[IP address] 


Dizmo is 
designed to be 
a multi-touch 
interface 
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dizm: 
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Downloads 


Get dizmo 


Linux 

Downloads 

TAR x86 (32biJ, Dcblon) 

Version 1 .0r2 Build 746 
(Fixulus) 

& Down load 40 MB 


TAR x64 |64bil, Debian) 
Version i 0r2 Build 746 
(Fixulus) 

Download 40 MB 

TAR x86 (32bit. Ubuntul 
Version l.Qr2 Build 746 
(Fixulus) 

& Download 40 MB 

TAR x64 (64bit, Ubuntif) 
Version J Gr2 Build 746 
(FiXUluS) 


U Builds are 
available for various 
bistros on the 
Download page, and 
you can also check 
the pricing plans 


$ Install dizmoSpace 

If you haven't already, head to www.di2m0.com, grab 
dizmoSpace and install it to the system you plan for it to work 
with. All you need to do is download the zip and unpack it, then 
click the Dizmo icon or run it from the terminal. 



Launch issues? 

. - If Dizmo is complaining about libraries when you try 
to run it, you’ll need to install some extra software. Open the 
terminal on the PC you’re working from and install the extra 
software with the following: 


$ sudo apt-get install libavahi-compat-libdnssd-dev 
$ sudo apt-get install libavahi-client-dev 


M Download node.js 

Now, we need to grab the latest version of node.js for the 
Raspberry Pi. Back in the SSH connection to your Raspberry Pi, 
use the following: 


$ sudo wget http://node-arm.herokuapp.com/ 

node_latest_armhf.deb 

$ sudo dpkg -i node_latest„armhf.deb 


A Dizmo widget is a HTMLf ile, 
packaging resources together to 
create an interface or graphic. Our 
HTMLfile usesjQuery 



Add framework 

Use node -v to check if it’s installed correctly - it should 
spit out a version number for you. Once that’s done, install 
expresses, which will be our web application framework: 

$ sudo npm install -g express 
$ sudo npm install -g express-generator 

Install framework 

Well create the folder www in var and create a symlink 
for everything to run. Do this by moving to var, creating www and 
making the symlink with: 

$ cd /var 
$ sudo mkdir www 
$ cd www 

$ sudo In -s /usr/local/lib/nodejnodules/ 
/node_modules 
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dizmr^j 

i, H industry 


Free Trtal 


Industry 

0\imo sells diretlly to consumers, creative* and enterprises. Besides consumers, the other categories con also act os channel 
partners, using dizmo as their white-label Ul software technology supplier, focusing on their core offerings. 

These categories include service providers, such os telecommunications providers, consumer electronics manufacturers, 
media and rmfertainmenl companies, marketing eg an ties, computer hardware/networking manufacturers, software vendors 
and home/office hardware retailers* They also comprise medium/large enterprises in multiple industrial segments 
(automotive, pharmaceutical, manufacturing, engineering, etc...) and In particular those specialized In loT products and 
solutions. 



Customers and channel partners 


Service providers 

Cable, telecommunications and/or satellite services 
providers or new entrants, global retailers / e-retailers, 
^commerce and internet providers. You are seeking ways to 
odd supplementary services which complement your core 
capabilities and enhance your positioning through mufti- 
channel, multi-service and multi-device offering. 



As it T s 

multi-touch, Dizmo 
is perfect for 
interactive table 
displays in meetings 

Internet 

ofThings 

It's not a very 
descriptive term, 
but the Internet 
ofThings can be 
almost anything. Any 
item that is or can 
be connected to the 
internet or networks, 
such as modern 
automated lights, 
can be connected 
up to Dizmo and the 
Raspberry Pi. 


Enjoy some pre- 
installed projects 
to see exactly what 
Dizmo can do 

Create 

a custom app 
to monitorthe 
temperature of your 
Raspberry Pi* and 
then go even further 

Create 
an entire custom 
display using 
a variety of 
information that 
can connect to and 
through the Pi 



Package file 

First, create the file package.json with sudo nano 
package o son, then enter: 

{ 

“name”: “ServeSysinfo”, 

“version": “0.0.1”, 

“dependencies": {“express": “4.x"} 

} 


hi* V** 54*rt* 


v*r - n4vlff(‘«Rprt$i'); 

app * etprtiiO; 

dpp.ux (ei^rtu. UilVct ..rfVwg * 
jj»p. Hi, tan I ){ 

toniole 

n( 


/public 1 1 


,ogi( '\ULvn1ng on ‘.JHC 


O A App node 

O Now, create a file called app.js and enter the following: 

var express = require('express'); 
var app = express 0; 

app.use(express,static( dirname + ‘/public’)); 

app.listen(3000, functionQ{ 
console. log(‘listening on *.3000’); 

}); 


Start node.js 

You can now start the node server by typing in: 

$ node app.js 

It will say it’s listening on *3000. Start up a new terminal, ssh in, 
and create the folder /public with mkdir /public to save all of the 
CPU data in. 



CPU information 

We are going to use the vcgencmd command to get the 
CPU information from the Raspberry Pi, We will write a script that 
will do this and then write the info to sysinfo.json. Download the 
filegrabsysinfo.sh from FileSilo and put it in /usr/local/bin. 

Makeacronjob 

We will make it so that the temperature is updated every 
ten minutes. You can make it update much faster if you want, but 
have a play around with that Open up cron with sudo crontab 
-eand add this at the end: 

*/10 * * * * /usr/local/bin/grabsysinfo.sh 
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Start creating the widget 

It is time to actually start building the widget. First of all, 
create a folder on your local machine called Gauge and cd to it. 
Now you need to download the first file called info.plist into here 
by using the following: 

$ wget x/info.plist 


■ an t4i vmm • bt »-*#-■/ 


•■v- 1 

1 hi Half 1 Hrluout 1 mi nil 1 ~moi 

30 I'tVK K Mh 1 ^ f JP Jin * !| Yffa 

D [*[ Till Q [JT Hi 

S r r-,1 S n Rtf u 

Indexfile 

A Dizmo widget is basically a 

HTML file, packaging 


resources together to create art interface or graphic. Here, we 
have the main HTML file that uses jQuery, which helps display 
the temperature. Still in the Gauge folder, download it with: 

$ wget x/i ndex.html 


With these building blocks, you can 
now start doing more interesting loT 
things - controlling the GPIO ports, 
getting more information 


Style guide 

Now we’ll add the CSS style sheet for the Dizmo widget. 
As usual, this styles up the display on the page that will become 
our widget, Download it with: 


We’ve gone 
fora simple CPU 
temperature gauge, 
but the possibilities 
really are endless 


wget x/style.css 


Final application 

The final step is to create the application.js file, which will 
call the temperature from the Raspberry Pi using Ajax. You can 
download it using: 

wget x/application.js 


Change the IPaddress to the one on your Pi. 

Once that’s done, you can test out the widget - compress the 
Gauge folder to a .zip and then change the .zip to a .dzm. Launch 
dizmoSpace and drag the dzm file onto it for itto start. 

1/ Get coding 

With these building blocks, you can now start doing more 
interesting loT things - controlling the GPIO ports, getting more 
information, having it connect to other objects to control them 
as well. Check out the Dizmo website for more details on projects 
that you can do. 
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Why 

Python? 

It s s the official 
Language of the 
Raspberry Pi, 

Read the docs at 

python.org/doc 


Forecast the weather 
with your Raspberry Pi 


Being someone who lives on the 
east coast of Canada, the weather is 
something that is consistently a topic 
of conversation. The common wisdom 
is that if you don’t Like the weather, just 
wait five minutes and it will change 
to something else. While people have 
used Raspberry Pis to create lots of 
applications like Twitter tickers, I thought 
that here we could look at how to write 
up a weatherticker in Python. 

There are many different services 
available that provide weather data 
through a number of different APIs. 
Some can be accessed directly 
through a URL, while others are a bit 
more complicated. Luckily, for the 
more complicated options there are 
wrappers written to make the data 
collection easier. We will look at several 


services and see how to pull data 
from a number of them. From there, 
you can decide how best to display all 
of this information. The first service 
we will look at is the one provided by 
Weather Underground (http://www. 
wunderground.com). 

This service uses weather 
information collected by individuals 
from around the world, using data 
from personal weather stations. As 
with most services, you will need to 
get an API key in order to pull down the 
weather data for your ticker. You can 
purchase a developer key for free, as 
long as you don’t download data more 
than 500 times per day or 10 times per 
minute. This should be adequate for 


personal use. If you need more than 
this, you can purchase an API key that 
covers more usage. Interacting with 
Weather Underground involves sending 
a request as an HTTP URL and receiving 
either a JSON orXMLfile back. 

In the sample code, we pull back the 
data as JSON. The first thing you will 
need is your location identifier. You can 
request a location identifier by either 
latitude and longitude or by geolocating 
your current IP address. You can even 
do a search by place name. Once you 
have this, you can go ahead and start 
to make data requests. You can import 
the urllib2 and json modules to make 
the request and parse the output. 
Let’s say you wanted to get the current 
conditions at Cedar Rapids. You could 
do this with the following Python code: 


f = urllib2.urlopen(‘http://api. 
wunderground.com/api/YOUR_KEY/ 
geolookup/conditions/q/IA/Cedar_ 
Rapids. json’) 

This will return a JSON file. You can now 
load this data and parse it with 

json_str = f.readQ 

json_parsed = json. loads (json_str) 

The json_parsed variable will now 
contain all of the available current 
conditions, such as temperature or 
precipitation. There are many other 
data features provided by the Weather 
Underground, including weather alerts, 
a three-day forecast, a ten-day forecast, 


hourly forecasts and tide forecasts. 
There is also historical information, in 
case you need historical data for some 
other project. 

The next service we will look at is that 
provided by forecast.! o. Forecast Jo 
aggregates weather data from several 
different sources around the world. It 
parses through all of these data sources 
and provides current weather conditions 
and a forecast for your location through 
an API over HTTP. The returned data can 
be a bit messy, so there are wrappers for 
many different environments, including 
Python. This wrapper is available on 
GitHub from Ze’ev Gilovitz (https:// 
github.com/ZeevG/python-forecast.io). 
While you can download and install from 
source, you should be able to install it 
usingpip with: 

pip install python-forecastio 

As with Weather Underground, you will 
need to go to https://forecast.io and 
get an API key in order to make requests. 
And, as with Weather Underground, 
this API key is free. Once you import the 
module, you can call Toad_forecastO T 
to get the data. The object storing the 
returned results contains everything 
available and has several access 
functions. For example, you can get the 
hourly forecast with the object function 
‘hourlyO’. These access functions have 
functions within them to access parts of 
the sub-data. For example, you can look 
at the hourly temperature with: 

by hour = forecast. hourlyO 
for hourlyData in byhour.data: 
prir hourlyData.temperature 

In most instances, the information 
available through the wrapper functions 
should be good enough. But, you may 


There are many different 
services that provide weather 
data through a number of APIs 
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have need of more control over your 
request. In these cases, the forecast.io 
module has a function called ‘manualO’. 
You can use this to send a particular URL 
data request to the forecast.io service to 
pull back the exact information you are 
interested in. 

The last option we will look at is the 
python-weather-api module. This 
module provides access to weather 
service providers such as Yahoo! 
Weather, weather.com and NOAA. This 
module is actually available as a package 
within Raspbian. You can install it with 
the command: 


Full code listing 


n m t urllib2 
import json 


f urllib2.urlopen( ‘http: //api .wunderground.com/api/YOUR_KEY/ 
geolookup/conditions/q/IA/Cedar_Rapids . json ’ ) 
json„string - f.readQ 


sudo apt-get install python- 
pywapi 

You can also install it with pip. Once 
you have it installed, you can import it 
and request data from any of the three 
data service providers. The three main 
functions are: 


parsed_json json. loads (json_string) 

location = parsed_json[‘ location’] [‘city'] 

temp_f parsed. json[ ‘ current.observation ’][ ‘ temp_f ' 1 


forecastio 


pywapi. get__weather_from_.yahoo() 

pywapi.get_weather_from_weather_ 

com() 

pywapi.get.weathe r_f r o m_noaa() 

These functions essentially get all of 
the available information from these 
different servers in a single call. You 
can then parse the results to pull out 
the information you are most interested 
in. The results actually come back as 
XML data and are then parsed in the 
return object. You can then pull out the 
relevant data by using keywords, such 
as ‘forecasts’. You should review the 
module documentation to see what 
information is available from each of the 
data sources. 

Once you have collected the weather 
data that you were looking for, you need 
to display this information. The simplest 
is to just print it out. This works well if 
you are using a console as the interface. 
There are also several LCD options 
available if you want to make a self- 
contained weather reporting service. 
The exact code used to handle the LCD 
will vary by manufacturer, but they all 
have very good documentation available. 
Now that you have weather reports being 
served to you, you will no longer have 
any excuses for being caught unawares 
by a storm or for showing up to work 
drenched by the rain. 


apikey “YOUR.KEY” 
latitude = 36,4 
longitude = 46.567 

forecast forecastio. load„forecast(apikey, latitude, longitude) 


by_hour forecast. hour ly{) 
fo hourly.data in by_.hourly.data: 
print hourly.data 


by.day forecast. daily () 
p r int by.day . sumrra ry 


pywapi 


we a t h e r_com_r e suit pywapi . ge t.we a t he r_f rom_wea the r .corn ( ‘ 1 0001 ’ ) 

yahoo.resul t = pywapi . ge t_we a t he r _f r om_ya hoo ( ‘ 10001 ’ ) 
noaa.result = pywapi. get_weather_from_noaa(‘KJFK') 


weather_com_result[ ‘cur rent.condit ions ' ] [ ‘ text ' ] 
ya hoo.result [ ' cond i t i on ’ ] [ ‘ te xt ’ ] 
noaa_result[‘weather’ ] 


Weather 

station 

You can use Python 
to log weather 
data and send 
it in to Weather 
Underground; 
just install the 
required module 
with; pip install 
weather This 
actually contains 
three separate 
submodules that 
need to be imported 
individually. The first 
provides a number 
of conversion 
functions, as well 
as calculation 
functions such as 
l weathenunits,calc_ 
wind_chill(y.The 
second, 'weather, 
stations', provides 
the capabilities to 
talk to the weather 
station over a 
serial connection, 
butthis module 
currently only talks 
to the Vantage and 
VantagePro.The 
third, "weather. 
services 1 , provides 
the functions to 
upload your data to 
the online services. 
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Print wirelessly with 
your Raspberry Pi 
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Wireless printing has made it possible to print to devices 
stored in cupboards, sheds and remote rooms. It has generally 
shaken up the whole process of printing and enabled output 
from smartphones, tablets, laptops and desktop computers 
alike. But you don’t have to own a shiny new printer for this to 
work; old printers without native wireless support don’t have to 
end up in the bin, thanks to the Raspberry Pi. 

The setup is simple. With your Raspberry Pi set up with a 
wireless USB dongle, you connect your printer to a spare USB 
port on the computer. With Samba and CUPS (Common Unix 
Printing System) installed on the Raspberry Pi, all that is left to 
do is connect to the wireless printer from your desktop computer, 
install the appropriate driver and start printing. 

CUPS gives the Raspberry Pi a browser-based admin screen 
that can be viewed from any device on your network, enabling 
complete control over your wireless network printer. 


Check your printer works 

Before starting, check that the printer you're planning to 
use for the project still works and has enough ink. The easiest 
way to do this is to check the documentation (online if you can’t 
find the manual) and run atest print. 


Printers S#*v*r 


Jobs 


RSS SubitcnpiNion* 
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Detect your printer 

With your Raspberry Pi set up as usual and the printer 
connected to a spare USB port, enter: 

lsusb 

This will confirm that the printer has been detected by your 
Raspberry Pi. In most cases you should see the manufacturer 
and model displayed. 

Install Samba and CUPS 

■ 

Install Samba to enable file and print sharing across 
the entire network: 

sudo apt-get install samba 
Next, install CUPS: 
sudo apt-get install cups 

With a print server created, begin configuration by adding 
default user ‘pi’ to the printer admin group: 

sudo usermod -a -G lpadmin pi 


Set up print admin 

UM 

Set up the CUPS print admin tool first. Boot into the 
GUI (startx) and launch the browser, entering 127.0.0.1:631. 

Here, switch to Administration and ensure the ‘Share 
printers’ and ‘Allow remote administration’ boxes are selected. 
Next, select Add Printer and enter your Raspbian username 
and password when prompted. 



Add your printer 

A list of printers will be displayed, so select yours 
to proceed to the next screen where you can confirm the 
details, add a name and check the Share This Printer box. 
Click Continue to load the list of printer drivers and select the 
appropriate one from the list. 


1 


Configure Samba for network printing 

Using a Windows computer for printing? Samba will 
need some configuration. Open ‘/etc/samba/smb.conf’ in nano, 
search (Ctrl+W) for ‘[printers]’ and find ‘guest ok’ which you 
should change as follows: 
guest ok = yes 

Next, search for “[print$].” Then change the path as follows: 

path = /usr/share/cups/d rivers 



Join a Windows workgroup 

With these additions made, search for ‘‘workgroup” in 
the configuration file and add your workgroup: 

workgroup = your_workgroup„name 
wins support = yes 

Make sure you uncommentthe second setting so that the print 
server can be seen from Windows. Save your changes and then 
restart Samba: 

sudo /etc/init. d/samba restart 



Accessing your printer on Linux 

Meanwhile, it’s a lot easier to access your wireless 
printer from a Linux, Mac OS X or other Unix-like system, thanks 
to CUPS, All you need to do is add a network printer in the usual 
way and the device will be displayed. 



WM 


Add AirPrint compatibility 

* w It's also possible to print wirelessly from your iPad 
using Apple’s AirPrint system. To do this, you need to add the 
Avahi Discover software: 

sudo apt-get install avahi-discover 
Your wireless printer will now be discoverable from your iPad or 
iPhone and will be ready to print. 
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Basic 


P/lemorv ussqb 


Hostname raspberrypi 
IP address 172-25 12 121 
Uptime 24 


Total memory 373.87 MB 

Used 6108 MB (16%) 
Free 31 7 79 MR (83% 


n 


r r o G0 ss o r 

CPU Name 

ARMv6-compat«bte processor rev 

Temperature 

OA ft/' 1 ftr a a ft^ 

35.80 °C / 96.44 

Bogomils 
Current speed (Hz) 

700000 

Overdocked speed (MHz) 

800 

Load Average 

0.25 0.10 0.07 


f ( TOI J 


n ■ i 

1 I u 

I Jf 1 S J* 




USOQC 




Total HDD space 
Used 
Free 


3.51 GB 
2.76 GB (78%) 
579.29 MB (16%) 


Top CPU 


LI I Ul 




system mfo ,sh 
kworker/u2:l 
tfplugd 
Ixpanel 
python 
Xorg 


PID: 2619 - 
PID; 2476 - 
PiD: 2417 - 
PID: 2273 - 
PID: 2083 - 
2051 - 


j% 


Create custom 

commands for running your Raspberry Pi 


Seeing through your 
webcam and setting an alarm are just two 
additional things you can do with your Pi 



Get the full details of 
the cu r re ntly ru nn ing system from the web 


What youS need 

Raspbian set to 
command Line 
Ras pCTL 

Internet connection 


Not everyone uses the Raspberry Pi 
while it’s hooked up to a monitor like a 
normal PC. Due to its size and excellent 
portability, it can be located almost 
anywhere that it can be powered and 
it’s widely used as a file server, media 
centre and for other nontraditional 
applications as well. Some of these uses 
won’t easily allow access to a monitor for 
easy updates and maintenance. While 
you can always SSH in, it’s a bit slower 
than a full web interface that allows for 
custom commands and a view of the Pi’s 
performance. We’re using software called 
RaspCTL, which is still in development, 
but works just fine for now. 


Update your Pi! 

To make sure the Raspberry Pi works as best it can, you’ll 
need to update Raspbian. Do this with a sudo apt-get update 
&& apt-get upgrade, followed by a firmware update with sudo 
rpi-update. Finally, if you’re booting to LXDE, enter raspi- 
configand change it to boot to command line to save power. 
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REMOTELY CONTROL YOUR RASPBERRY PI 


fU\ Edit the IP 

For everything to work more easily, you should set the 
Raspberry Pi to have a static IP of your choice. To do this, edit the 
networking config by using: 

$ sudo nano /etc/network/interfaces 

...and change ifaceethO inetdhcptoifaceethO inet static. 



Set up a static IP 

Add the following lines under the iface line with your 
relevant details: 

address 192. 168.1. [IP] 
netmask 255.255.255.0 
network 192.168.1.0 
broadcast 192.168.1.255 
gateway 192. 168.1. [Router IP] 

Ready to install 

You’ll need to grab the public keys for the software 
we’re going to install by usingthe following commands. The first 
will take just a moment to download the software, white the 
other quickly installs it: 

$ wget debrepo.krenel.org/raspctl.asc 
$ cat raspctl.asc | sudo apt-key add - 



Add the repository and install 

Add the repository to the source’s file with the 
followingcommand: 

$ echo "deb http://debrepo.krenel.org/ raspctl 
main” | sudo tee /etc/apt/sources. list. d/raspctl. 
list 

...and finally install the software with: 

$ sudo apt-get update 
$ sudo apt-get install raspctl 


Please sign in 



Access your Raspberry Pi 

Now the software is installed you can start to access 
your Raspberry Pi from anywhere on your network. To do this 
type the followinginto your address bar, with the IP being theone 
we set up earlier: 

http://[IP]:8086 



Change your password 

The default username and password is admin for both 
fields, and you should make sure to change that before doing 
anything else. Go to Configuration along the top bar and find 
the Authentication field at the bottom of the page. Input the 
original password (admin), followed by your new passwords. 
The username will remain as admin. 



Aft First command 

Go to Commands on the top bar to begin creating 
commands to run. Here you’ll need to add a class - a user- 
defined way to filter your commands that won’t affect the way 
it’s run - a name for the command and the actual command 
itself. The commands won’t necessarily run from the pi user 
u nless yo u tweak the config f i les . 

More functions 

The web interface has a few extra functions apart from 
running commands, such as the ability to view the webcam and 
connectto radio services. Updating the software every so often 
will also allow you to make sure it keeps working. Play around 
with it and see what best suits you. 
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SOFTWARE 


Turn your Pi into a motion 
sensor with SimpleCV 


Why 

Python? 

ft’s the official 
language of the 
Raspberry Pi. 

Read the docs at 

python.org/doc 


The Kinect has proven a popular piece 
of tech to use with the Raspberry Pi. But 

not everyone has access to this kind of 
hardware. Another class of project that 
is popular with Raspberry Pis is using 
USB cameras to create monitors of one 
form or another. A lot of these projects 
use command line applications to talk to 
the USB camera and generate images 
or movies that are used as part of the 
system. But what if you are writing your 
own program in Python and you want to 
add some form of image system to your 
code? Luckily, there are several modules 
available for you to choose from. In this 
article, we will take a look at using SimpleCV 
to get your program to talk with the USB 
camera. SimpleCV is built on top of OpenCV, 
making it easier to use for common tasks. 
Assuming you are using Raspbian, you 
can go to the main page for SimpleCV 
(www.simplecv.org) and download a DEB 
file.To install it, you can simply run: 

sudo dpkg -i SimpleCV-l,31.deb 

Before you do, however, you will want to 
install all of the dependencies. You can do 
that with the command: 

sudo apt-get install python 
python-support python-numpy 
python-scipy ipython python- 
opencv python-pygame python- 
setuptools 

You can check that everything worked 
by running the command ‘simplecv’ at 
the command line. This will start Python 
up and run the interactive shell that is 


provided by the SimpleCV module. You 
can then try connecting to your USB 
camera and pulling images from it. 

Now that everything should be up and 
running, how do you actually use it in your 
own code? You can load allot the available 
functions and objects into the global 
scope with the command: 

from SimpleCV np< rt * 

Making sure that you have your USB 
camera plugged in, you can now create a 
camera object with: 

cam CameraO 

This will load the required drivers, and 
initialise the camera so that it is ready 
to start taking pictures. Once this object 
creation returns, you can grab an image 
from the camera with: 

img cam.getlmageQ 

At least in the beginning, when you are 
experimenting, you may want to see what 
this image looks like. You can do this with: 

img.showO 

You will, of course, need to have a GUI 
up and running in order to actually see 
the movie. Otherwise, you will get an 
error when you try and call ‘img.showO’. 
Don’t forget that you can always pull up 
documentation with commands like: 

help (cam) 
help(img) 


With the Image’ object, you can do some 
basic processing tasks right away. You 
can scale an image by some percentage, 
say 90%, with ‘img.scale(90,90)'. You 
can also crop an image by giving it a 
start location and saying how many 
pixels across and how many up and 
down you want to crop to. This looks 
like ‘img.cropd 00,1 00,50,50)'. SimpleCV 
has the location (0,0) as the top-left 
corner of an image. 

The really interesting functionality in 
SimpleCV is the ability to find features 
within an image and to work with them. 
One of the clearest features you can look 
for is blobs, where blobs are defined as 
continuous tight regions. The function 
‘img.findBlobsO’ will search the captured 
image for all blobs and return them as a 
Featu reSet. You can set the minimum 
number of pixels to consider a single 
blob, the maximum number of pixels, 
as well as a threshold value. If you are 
looking at a region that has some hard 
edges, you can use the function 'img. 
findCornersO’. This function will return 
a FeatureSet of all of the corners within 
the captured image. A very simple 
monitor program could use one of these 
functions to see if there is any motion 
happening. If there is, then the set of 
blobs or corners will change from one 
frame to another. Of course, a little 
more reading will lead you to the 'img. 
findMotionO’ function. This function will 
take two subsequent images and see if 
any motion can be detected going from 
one to the other. The default method is to 
use a block matching algorithm, but you 
can also use either the Lucas-Kanade 
method orthe Horn-Schunck method. 

The above methods wilL let you know 
some features of the captured images, 
and if any kind of motion has occurred. 
But what if you are more interested in 
identifying whether people have been 
moving around? Maybe you have an 
area you need to secure from espionage. 


SimpleCV is built on top of 
OpenCV, making it easier to 
use for common tasks 
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TURN YOUR PI INTO A MOTION SENSOR WITH SIMPLECV 


You can look for blobs - 
continuous light regions 


In this case, you can use the function j 

‘img.findSkintoneBlobs{)’. You can use Uil VwV ' 

a binarise fitter threshold to set what 

constitutes a skin tone. If you need to 

do more, you have access to all of the 

underlying OpenCV functionality. One of 

these more advanced functions is face Simpiecv 

recognition. You can use the function 'img. 

findHaarFeaturesO’ to look for a known Make sure yo 

type of object. If you wanted to look for then you :an 

faces, you could use something like: cam Camera () 



Ab Any basic USB webcam or 
surveillance monitor will do for this 


faces HaarCascade(“. /SimpleCV/ 
Features/HaarCascades/face. 
xml”,‘‘fnyFaces”) 
i mg . f i nd Ha a rFeatu re s (fa ce s) 


img cam.getlmage() 


img2 - img. scale (50, 50) 


When you start developing these types 
of programs, one thing that might come 
into play is timing issues. You want to 
be sure that your code is fast enough 
to catch everyone that may be moving 
through the field of the camera. In order 
to figure out what is costing time, you 
need to be able to profile your code, The 
shell in SimpleCV provides a feature 
called ‘timeit’ that will give you a quick 
and dirty profiling tool that you can 
use while you are experimenting with 
different algorithms. So, as an example, 
you can see how long the ‘findBlobsQ’ 
function takes on your Raspberry Pi with 
something like: 

img cam.getlmage() 

timeit img.findBlobs() 

Once you find and fix the bottlenecks in 
your code, you can create the end product 
for your final version. 

With this article, you should now have 
enough to start using cameras from 
within your own programs. We have only 
been able to cover the bare essentials, 
however, so don’t forget to go check out 
the documentation covering all of the 
other functionality that is available in the 
SimpleCV module. 


blobs = img.findBlobsO 


blobs. draw () 


corners img.findCornersQ 


img2 cam . getlmage() 


motion img2.findMotion(img) 


img.listHaarFeaturesQ 


faces HaarCascade{ ‘ face . xml ’ ) 


found_faces img. findHaarFeatures(faces) 


my_img = Image (‘my_image.jpg’) 


img. save( ‘ camera . png’ ) 


Importin 




W 



SimpleCV is built on top of OpenCV and 
provides a simplified set of functions. 
But what can you do if you have more 
complicated work to do? You always have 
the option of using OpenCV directly to 
gain access to the full set of functions. 
You can import the module into the local 
namespace with: 


cv2 


* 


Not only do you have the usual image 
manipulation functions and the feature 
recognition tools, but you also have the 
ability to process video. You can use 
meanshift and camshift to do colour 
based motion detection. There are 
functions to look at optical flow, These 
look at apparent motions in a video, from 
one frame to the next, that are caused by 
either the object moving or the camera 
moving. You can even subtract the 
background from a moving foreground 
object This is a common preprocessing 
step in vision systems. You can even 
construct 3D information from a set 
of stereo images gathered by a pair of 
cameras. With OpenCV, you really can 
deal with almost any vision problem you 
might be tackling. 
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a simple synthesiser 


We are going to take you through the basics of wavetable 
synthesis theory and use that knowledge to create a real- 
time synthesiser in Python. At the moment, it is controlled 
by the computer keyboard, but it could easily be adapted to 
accept a MIDI keyboard as input. 

The Python implementation of such a synthesiser turns out 
to be too slow for polyphonic sound (ie playing multiple notes 
at the same time) so we'll use Cython, which compiles Python 
to C so that you can then compile it to native machine code to 
improve the performance. The end result is polyphony of three 
notes, so this is not intended for use as a serious synthesiser. 
Instead, this tutorial will enable you to become familiar with 
synthesis concepts in a comfortable language: Python. 

Once you’re finished, try taking this project further by 
customising the mapping to better fit your keyboard layout, or 
tweaking the code to read input from a MIDI keyboard. 


A*1 Install packages 

Using the latest Raspbian image, install the required 
packages with the following commands: 

sudo apt-get update 
sudo apt-get upgrade 

sudo apt-get install python-pip python2.7-dev 
portaudiol9-dev 

sudo pip install cython pyaudio 

The final step compiles Cython and PyAudio from source, so you 
might want to go and do something else while it works its magic. 

Disable built-in sound card 

We had issues getting the Raspberry Pi’s built-in sound 
card to work reliably while developing the synthesis code. For 
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that reason, we are using a USB sound card and will disable the 
built-in card so that the default card is the USB one: 

sudo rm /etc/modprobe. d/alsa* 
sudo editor /etc/modules 

Change ‘snd-bcm2835’to‘#snd-bcm2835 , and save, then: 

sudo reboot 

Test sound card 

Now we can test the USB sound card. Type alsamixer and 
then ensure that the volume is set to a comfortable level, if you’re 
plugging speakers in, you’ll probably want it set to 100%. Then 
type speaker-test, which will generate some pink noise on the 
speakers. Press Ctrl+Cto exitonceyou are happy that it's working. 

Start project 

Start by creating a directory for the project. Then 
download one cycle of a square wave that we will use as a 
wavetable, like so: 

mkdir synth 
cd synth 

wget liamfraser.co.uk/lud/sy nth/square. wav 

Create compilation script 

We need a script that will profile our Python code 
(resulting in synth.html). Generate a Cython code for it and 
finally compile the Cython code to a binary with GCC: 

editor compile. sh: 

#!/bin/bash 

cython -a synth. pyx 

cython —embed synth. pyx 

gcc -march=armv7-a -mfpu=neon-vfpv4 -mfloat- 

abi=hard -03 -I /usr/include/python2.7 -o synth. 

bin synth, c -lpython2.7 -lpthread 

(Notice the options that tell the compiler to use the floating 
point unit.) Make it executable with: 


CODE A SIMPLE SYNTHESISER 


pyaudio 

time 

array import * 

cpython c import array as c_array 
wave 

threading 

tty terrnios sys 


(self) : 
self notes [ ] 
self fill_notes() 

fil 1 note; (self) : 

frequency 8. 175799 

ratio = 1,0594631 

i n range ( 0 , 128): 

self notes append (frequency) 

frequency = frequency ratio 

(self, n): 
self notes [n] 

cdef ..lass ADSR: 

cdef float attack, decay, sustain amplitude 

cdef float release, multiplier 

cdef public char state 

cdef int samples jperms , samplesgone 

in L ( self , sample rate ) : 

self attack - 1.0/100 
self decay = 1,0/300 
self sustain_amplitude 0 - 7 
self release 1,0/50 
self state = 'A' 
self multiplier 0,0 

self samples_per_ms = int{sample_rate 10OC) 
self samples_gone = 0 

(self): 

self samplesgone += 1 

self samplesgone self samples_per_ms : 
self samples_gone 0 

2a 2 O # 

self multiplier 

self state = J A': 
self multiplier += self attack 
self multiplier = 1 : 
self state ' D ' 
self . state = * D 1 : 
self multiplier -= self decay 

self multiplier self sustain_amplitude : 
self . state = 'S' 
self state 'R' : 
self multiplier -= self release 

self multiplier 


r 
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chmod +x compile. sh 


SOFTWARE 




cdef : 

cdef int wavetable_len 
cdef float position, stepsize 
cdef c_array array wavetable 
cdef public float freq 
cdef public object adsr 
cdef public int off 

(self, wavetable, samplerate, freq): 

self wavetable wavetable 

self wavetablelen len( wavetable} 

self freq = freq 


self step_size self wavetablelen \ 

( freq float ( samplerate ) ) 

self position =0.0 

self adsr ADSR (samplerate) 

self off = 0 


(self ) : 

("Note: Frequency = {0}Hz, " 

"Step Size = {1}") format (self freq, 

self stepsize) 


cpdef int next_sample(self ) : 

cdef int pos_p_nt, pi, p2, interpolated 
cdef int out_sample 0 
cdef float pos_dec 
cdef float adsr 

adsr = self adsr next_val( ) 


adsr 0 : 
self off = 1 

outs ample 

posint int (self position) 
pos_dec self position pos_int 


pi = self wavetable [ posint ] 

p2 = 0 


pos int 1 — self wavetable_len : 
p2 self wavetable [ 0 ] 

p2 self wavetable [ pos_int 1 ] 


interpolated = int (pi +- ( (p2 - pi) posdec)) 
outsample f= int (interpolated adsr) 


self position self stepsize 

self position self wavetablelen: 
self position self wavetable_len 


I 


Start to code 

H) 

Our code file is going to be called synth. pyx. This 
extension tells Cython that it is not plain Python code (and as 
such, can’t be ran in a normal Python interpreter). Create the 
file with your favourite editor and add the imports. 


fVJ MIDI Table 

To synthesise the standard note of a piano, we need 
a table of MIDI values. MIDI notes range from 0-127. MIDI note 
60 is middle C on a piano. The MIDI Table class has a ‘get note’ 
function that returns the frequency of a note when you give it 
a MIDI note number. 



A visual representation of an Attack, Decay, 
Sustain, Release curve 


Attack, Decay, Sustain, Release 

The ADSRclass applies a volume curve overtime to the 
raw output of an oscillator. It does this by returning a multiplier 
to the note that is a multiple between 0.0 and 1,0. The version 
we provide has an attack time of 100 ms, a decay time of 300 
ms and a release time of 50 ms. You can try changing these 
values to see how it affects the sound. 

The ADSR class does a lot of maths (44,100 times per 
second, per note). As such, we want to give types to all of the 
variables so that the maths can be optimised into a raw C loop 
where possible, because Python has a massive amount of 
overhead compared to C. This is what the cdef keyword does. 
If cdef public is used, then the variable can also be accessed 
from inside Python as well. 

AQ Generate notes 

^^7 The note class is the core of our synthesiser. It uses 
the wavetable to generate waves of a specific frequency. The 
synthesiser asks the note class for a sample. After generating a 
sample, the ADSR multiplier is applied and then returned to the 
synthesiser The maths of this are explained in the synthesis 
theory boxout on the opposite page. 

The note class does as much maths as the ADSR class, so 
it is optimised as much as possible using cdef keywords. The 
cpdef keyword used for the next.sample function means that 
the function can be called from a non-cdef class. However, the 
main synth class is much too complicated to give static types 
to absolutely everything. 

The audio flow 

This synth class is the main class of the application, it 
has two sample buffers that are the length of the buffer size. 
While one buffer is being played by the sound card, the other 
buffer is being filled in a different thread. Once the sound card 
has played a buffer, the callback function is called. References 
to the buffers are swapped and the buffer that has just been 
filled is returned to the audio library. 

The smaller the buffer size, the lower the latency. The 
Raspbian image isn’t optimised for real time audio by default so 
you may have trouble gettingsmall buffersizes. It also depends 
on the USB sound card used. 


CODE A SIMPLE SYNTHESISER 


out_s ample 


RUFSIZE 

SAMPLERATE 


in (self): 

self audio pyaudio PyAudio{ ) 


self buf_a array ( ' h ' , [ 0 ] Synth BUFSIZE ) 

self buf_b - array ('h', [ 0 ] Synth BUFSIZE) 


self playbuf self bufjb 
self newbuf self buf_a 

self loadwavetable ( ) 
self notes = [ ] 
self notes_on = [ ] 


self more_samples threading Event ( ) 
self exit = threading Event ( ) 


self midi_table MIDiTable() 

(self) : 

"'Exiting" 
self exit set ( } 
self stream stop_stream( ) 
self stream close ( ) 


st i am init ( self ) : 

self stream self audio open( 

format pyaudio palnt!6, 
channels 1 , 
rate - Synth S AMPLERATE , 
output = True, 

frames_per_buifer Synth BUFSIZE, 
stream_callback self callback) 

I wavetat (self): 


fh wave 

assert fh 
assert fh 
assert fh 


open ( ' square wav ' , " r ' ) 
getnchannels ( ) 1 

getf ramerate ( ) Synth SAMPLERATE 

getsampwidth( ) 


data f h readf rames ( f h getnf rames { ) ) 

self wavetable array ( 'h' ) 
self wavetable fromstring(data) 

(self) : 
tmp self playbuf 
self playbuf self newbuf 
self newbuf tmp 



SOFTWARE 


A major issue is that the sound 
card uses 16 -bit signed integers 
to represent a sample. However, 
Python doesn’t support this type 


self moresamples set( ) 
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( self , indata , f ramecount f 
time info, status } : 


self swap_buffers ( ) 

(self playbuf tostring(), 
pyaudio paContinue) 

do sample (self, int i) : 
cdef int outsample - 0 


note : self notes: 
note* off: 

self notes remove (note) 
out_sample - note next_s ample ( ) 
self newbuf [ i ] out_s ample 

( self ) ; 

cdef int i 

self exit is_set() == False: 

i range(0, Synth BUFSIZE) : 
self do_sample(i) 



self morels ample s clear ( ) 
self more samples wait() 

star (self): 
self streaminit ( ) 

t threading Thread (target^ self synth_loop) 
t* start ( ) 

freq on ( self , float freq) ; 

n Note (self wavetable, Synth SAMFLERATE, 
freq ) 
n 

self notes append(n) 

(self, float freq ) : 

n in self notes: 
n.freq =- freq: 
n adsr. state = ord('R r ) 

note_on (self, n ) : 

self f region ( self midi_table get_note(n)) 
self notes jon append(n) 






CODE A SIMPLE SYNTHESISER 


Synth loop 

The start method of the synth class initialises the audio 
hardware and then starts the synth_loop method in its own 
thread. WhiLe the exit event is set to false, the do_sample 
function is called. 

The do_sample function loops through the notes that are 
currently turned on and asks for a sample from each one. These 
samples are shifted right by three (ie divided by 2 A 3) and added 
to out_sample. The division ensures that the output sample 
can’t overflow {this is a very primitive method of adding notes 
together, but it works nonetheless). 

The resulting sample is then put in the sample buffer. Once 
the buffer is full, the more_samples condition is cleared and 
the synth_loop thread waits to be notified that the buffer it 
has just built has been sent to the audio card. At this point, the 
synth can fill up the buffer that has just finished playing and 
the cycle continues. 

Turn on notes 

There are both note_on/off and freq_on/off functions 
that enable either MIDI notes or arbitrary frequencies to be 
turned on easily. Added to this, there is also a toggle note 
function which keeps track of MIDI notes that are on and turns 
them off if they are already on. The toggle note method is used 
specifically for keyboard input. 

Add keyboard input 

For keyboard input, we needed the ability to get a 
single character press from the screen. Python's usual input 
code needs entering before returning to the program. Our 
code for this is inspired by: https://code.activestate.com/ 
recipes/577977-get-single-keypress. 

There is a mapping of letters on a keyboard to MIDI note 
numbers for an entire keyboard octave. We have tried to 
match the letter spacing to how a piano is laid out to make 
things easier. However, more innovative methods of input are 
left as an exercise to the reader. 


(self, n}: 

self freq_off(self miditable getnote ( n ) ) 
self notes_on remove (n) 

(self, n) : 
n in self notes_on: 

"note {0} off" format (n) 
self note_off(n) 

r\ j LZ q • 

* 

ijr note { 0 } on" format (n) 
self note_on(n) 

* 

i ni - (self, synth ) : 

self synth synth 


self keymap = {'a' 

60, 

i |ga f 

f s 

7 

UZ* , 

* e , 

62 , 'd' 

64, 'f' 

1 

f 

*t r 

66, *q r 

67, 'y' 

oo. 

*h r 

6 9 f l u r 

70, 'j' 

71 t 


self notes_on [ j 


getch ( ) : 

fd sys stdin fileno ( ) 

old_settings termios tcgetattr ( fd) 

■ 

tty setraw(fd) 
ch sys stdin read(l) 

termios tcsetattr(fd, termios TCSM3RAIN, 

oldsettings ) 

return ch 

(self) : 

True: 

c = self getch {) 


Put it all together 

“ The main function of the program creates an instance 
of the synth class and then starts the audio stream and synth 
loop thread. The start function will then return control to the 
main thread again. 

At this point we create an instance of the KB input class 
and enter a loop that gets characters and toggles the 
corresponding MIDI note on or off. If the user presses the 
Q key, that will stop the synth and end the input loop. The 
program willthen exit. 

Compile the code 

Exit your editor and run the compile script by typing 
the following command: 

./compile, sh 

This may take around 30 seconds, so don’t worry if it isn’t 
instant. Once the compilation has finished, execute the synth. 
bin command using: 

./synth, bin 

Pressing keys from A all the way up to K on the keyboard will 
emulate the white keys on the piano. If you press a key again 
the note will go off successfully. 


c == 'q': 
self synth stop( ) 


c in self keymap: 
n = self keymapfc] 
self synth togglenote ( n ) 

name =■ " main " : 

s = Synth ( ) 
s start ( ) 
kb KBInput(s) 
kb loop( ) 



Thesimple user interface. Notice how the step size inthe wavetable varies with frequency 




Modify a 
retro radio 


Enhance Minecraft 
with your Pi 


130 Build a complex 
LED matrix 

Program your own tight system 


Build a Raspberry Pi 
car computer 

Make your own touchscreen navigator 

How I made: RasPiViv 

Investigate an environmental control system 


Easily add touch controls to your projects 


How I made: Joyfone 

A new type of electronic keyboard 

Simulate traffic lights 
using your breadboard 

Try your hand at hardware engineering 


Build your own looping drum machine 

120 Transform your Pi into a 
micro oscilloscope 

Transform your RasPi with BitScope Micro 

124 How I made: Pi Glove 2 

Control lights, send texts and more 

126 Assemble a Minecraft 
power move glove 

Enhance your game with this cool hack 


142 Program a quadcopter 

Take to the skies with this gadget 


148 20 Raspberry Pi 
hacking project: 


Repurpose everyday items 























BUILD A RASPBERRY PI CAR COMPUTER 

j 



Cars are getting clever. These days, with smart navigation 
interfaces built into new cars, you don’t need to go out and 
buy yourself a TomTom to get help with directions. But if 
you’ve got a Raspberry Pi then you don't even need to buy 
that - let alone a new car! 

In this project we wilt show you how to build your own 
car computer with your Pi, a quality touchscreen like the 
9-inch model from SainSmart that we’re using here, and a 
few other bits like a GPS module and USB 3G modem. Your 
CarPi will be able to use open source navigation software 
Navit to show your route map on screen, plus speech 
synthesis to read out directions, and it will also be able to 
check your location and give you weather reports. It’ll work 
as a music player too, of course. 

It's an ambitious project, but you will gain a solid 
understanding of custom-made interfaces, navigation 
software and geolocation data, touchscreen calibration, 
speech synthesis and more. While you don’t have to use 
the same SainSmart screen as us, we do recommend it for 
this project as it is one of the few large touchscreens out 
there for the Pi, There are more improvements at the end 
too, so check the components list, make sure you've got 
everything and let’s get started! 




ELECTRONICS 




Above We’re using 
Adafruifs excellent 


Install navigation software 

Beginto install the Navit navigation software by entering: 

sudo apt-get install navit gpsd gpsd-clients espeak 
sudo nano /etc/default/gpsd 
set STARI_DAEMON= 1 ‘ true” 


GPS Breakout kit 


here: bit.ly/1G8X2gw 


...and set: 


Basic configuration 

Boot up your Raspberry Pi and expand the filesystem 
using raspi-config. Go to Advanced Options and disable the 
Serial connection - you’ll need this to talk to the GPS module 
later. In raspi-config, enable X at boot as the pi user. Say Yes to 
reboot. Once rebooted, ensure your packages are up to date with: 


DEVICES- ’/dev/ttyAMA0” 

Start the G PS daemon with : 
sudo /e tc/i nit. d /gpsd start 
You can check it’s working by looking at the GPS data with: 



sudo apt-get update 
sudo apt-get upgrade 



GPIO 

Raspberry Pi Model B+ V1.2 
© Raspherry Pi 2014 


Art Connect GPS module 

Vrfc Solder the pin headers onto the Adafruit GPS module. 
You can also solder the battery connector which is used to keep 
the device partially active, giving a fasterfix. You only need to use 
4 pins: 3.3V, ground, serial transmit and serial receive. Power the 
Pi off again before connecting anything. 

As we are using GPS, the antenna will have to go outside or 
under a window to gain signal Connectthe antenna to the board 
and power everything back on. The light on the GPS module will 
flash frequently while finding a fix. Once it has one, it will blink 
every 15 seconds. 


cgps -s 




Connect the screen 

,f The SainSmart screen doesn’t come with any written 
instructions. Instead there is a YouTube video on their website 
with details about how to put it together: bit.ly/1DF6eJJ. The 
important part is that the DC power supply should be 12V. 


Set the screen resolution 

V/W E We will have to force the correct resolution (1024x600) 
for the screen by editing /boot/config.txt with sudo. To do so, 
add the following options: 



frame buff er_width=1024 
frame buffer_height=600 
hdmi_force_hotplug-l 
hdmi_cvt=1024 600 60 3 0 0 0 
hdmi_group=2 
hdml mode=87 


For the changes to properly take effect you will need to reboot 

with sudo reboot. 




Download kernel source 

To start the touchscreen, you need to compile an 
extra kernel module to support it, The program rpi-source 

(github.com/notro/rpi-source/wiki) will find the source of 
your kernel. Install rpi-source with: 




sudo wget https://raw.githubusercontent.com/notro/ 
rpi-source/master/rpi-source -0 usr/bin/rpi-source 
&& sudo chmod +x /usr/bin/rpi-source && /usr/bin/ 
rpi-source -q -tag-update 


Then run rpi-source to get the source of the running kernel. 
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Update GCC 

\#/ Recent Raspberry Pi kernels are 
compiled with GCC 4.8. Raspbian only 
comes with 4.6 so you will have to install 
4.8 to continue with the following steps. 
Do this by entering: 


sudo apt-get install -y gcc-4.8 
g++-4.8 ncurses-dev 


Then you have to set GCC 4.8 as 
the default: 

sudo update-alternatives 
— install /usr/bin/gcc gcc /usr/ 
bin/gcc-4.6 20 
sudo update-alternatives 
— install /usr/bin/gcc gcc /usr/ 
bin/gcc-4.8 50 
sudo update-alternatives 
— install /usr/bin/g++ g++ /usr/ 
bin/g++-4.6 20 
sudo update-alternatives 
— install /usr/bin/g++ g++ /usr/ 
bin/g++-4.8 50 


rtfi; Pickthe module to compile 

Rpi-source puts the kernel 
source in a folder called Tinux’. To 
choose the USB Touchscreen Driver, 
enterthe following: 


cd linux 
make menuconfig 

Device Drivers -> Input device 
support -> Generic input layer 
(needed for keyboard, mouse, 

-> Touchscreens (press space 
to include) -> USB Touchscreen 
Driver (press M to make module) 


Once you’ve done that, you then need 
to make sure you save your changes as 
‘.config’ and run scripts/diffconf ig to see 
the differences. 


Full code listing 


import os sys, requests, pygame 

from gps import * 

from pygame. locals import * 

* 

( H S S ¥ V H H L HI 1 H 

apikey = “7232alf6857090f33b9dlc7a74721” 

Qstaticmethod 
def latlon(): 

gpsd = gps(mode“WATCH_ENABLE) 


True : 

report = gpsd.next() 

report [ :ss ] == ‘TP : 

gpsd.close() 

report.[ ], report[ ] 
None, None 


Ostaticmethod 
def usefuldata( j) : 

d - j [■ data ’][' current _condi t ion ’] [0] 

out = “Now - Temp: {0}C, Feels Like: (1}C, Description: {2}\n”\ 

. forma t(d[ * temp_C ’ ] , 

d[ 1 FeelsLikeC ], 

d[ 4 weatherDesc ][< ][ alue ]) 

hourly = j [ data ] [ ‘ weat her ] [0] [ ' hour ly ] 

hour_count = 1 

for h in hourly: 

out += (“+{0}hr - Temp: {1}C, Feels Like: {2}C, Chance of Rain:” 
“ {3}%, Description: {4}\n”)\ 

. format(hour_count , 
h[ empi ], 
h[ FeelsLikeC ], 
h[ ‘chanceof rain ’ ] , 
h[ weatherDesc 1 [01 [ ‘ value ]) 

hourcount += 1 



Compile and install 
the module 


Now you need to compile and install the 
module. Do so by entering: 


make prepare 

make SUBDIRS=drivers/input/ 
touchscreen modules 
sudo make SUBDIRS-d rivers/input/ 
touchscreen modules_install 
sudo depmod 


If you unplug and reconnect the 
touchscreen, it should work fine but it 
will probably need calibrating. 


out . rstrip() 


updateO : 

errstr = “Error getting weather data" 

lat, Ion = WeatherClient latlonQ 
lat =- None or Ion == None: 
errstr 


api_req (“http : //api . worldweatheronline . com/f ree/v2/ weather . ashx” 

“?q={0}%2C{l}&format=json&key={2}’’) . format(lat, Ion, 

WeatherClient . apikey) 


r - None 
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SainSmarf’s 
9-inch HDMi/VGA 
touchscreen (bit. 
Ly/1Ciu4H9) has a 
fantastic display 
and is perfect 
for ail sorts of 
Pi projects 


Adafruifs Ultimate 
GPS Breakout kit 
provides Navit 
and the weather 
function with the 
location data that 
they require 


Embed 
the screen 


We’ve looked at 
thePiTFT and the 
HDMIPi before, 
buttheSainSmart 
touchscreen 
we’re using here is 
uniquely suited to 
many embedded 
projects. It’s larger 
than the PiTFTbut 
also without the 
large bezeLsofthe 
HDMIPi -and it’s 
incrediblythin -so 
ifs the kind of thing 
that is really useful 
for installation 
projects, whether 
that’s something as 
simple as a photo 
slideshow in areal 
picture frame ora 
home automation 
control interface 
embedded into a 
cupboard door. 



The screen 
control panel that 
comes with the 
SainSmart screen 
enables you to 
easily change the 
display settings 
(i.e. brightness, 
contrast, etc) as 
well as the input 
(i.e. HDMI, VGA, 
AVI , etc) 


As well as the main 
controller board, 
the touch screen 
is connected to 
a four-line USB 
controller which 
then plugs into the 
Pi’s USB port 


Calibrate the touchscreen 

(J ■ 

At this point, you can easily calibrate the touchscreen by 
enteringthe following: 


cd /etc/Xll 

sudo mkdir xorg.conf.d 
cd xorg.conf.d 

sudo nano 99-calibration. conf 


1 Download maps 

I Navit needs maps; download them from maps.navit- 
project.org, You can either use the web browser on the Pi or 
download the map from another machine and copy it using 
scp. Use the predefined area option to select where you live. 
The smaller the area that you pick, the less data you will have to 
process. Here the UK has a map size of 608 MB. Now move the 
map to the navit folder: 


...with the following content: 

Section “InputClass" 

Identifier “calibration” 

MatchProduct “eGalax Inc. USB TouchController 
Option “SwapAxes” “1” 

Option “InvertX” “1” 

EndSection 


mkdir -p /home/pi/. navit/maps 

mv /home/pi/Downloads/$your_map /home/pi/. 

navit/$country.bin 

For example: 

mv /home/pi/Downloads/osm_,bbox_-9.7,49.6, 2.2,61.2. bin 
/home/pi/, navit/maps/UK.bin 


Invert X actually inverts Y because the axes have been swapped 
around. Reboot again for these changes to occur. Now the 
calibration is roughly correct, download an input calibrator that 
Adafruit have packaged already. 

wget http://adafruit-download.s3.amazonaws.com/ 

xinput-calibrator_0.7.5-l_armhf.deb 

sudo dpkg -i xinput-calibrator_0.7.5-l_armhf.deb 

DISPLAY=:0.0 xinput_calibrator 

DISPLAY=:0.0 is useful because you can run the program from 
any terminal (including an SSH session) and have it appear on 
the touchscreen. Touch the points on the screen as prompted. 
Once the program is finished, you should get an output that is 
similar to the following: 

Option “Calibration” “84 1957 270 1830” 

Add it to the ‘99- calibration. conf' file that we created earlier 
just below the other Option entries. 




Navit configuration 

Idu Sudo-edit /etc/navlt/navit.xml with your favourite 
editor. Search for openstreetmaps, Now disable the sample 
map above, enable the openstreetmap mapset and set the 
data variable to where you just moved your map. In this case 
it looks like this: 


<! — Mapset template for openstreetmaps — > 
<mapset enabled- ‘ye s”> 

<map type=“binfile” enabled=“yes” data=“/home/ 
pi/. navit/maps/UK. bin”/> 

</mapset> 


Then search for osd entries similar to: 

<osd enabled=“yes” type-“compass”/> 

...and enable the ones you want - we recommend enabling 
them all. You may wantto zoom in closer than the default map 
layout. A zoom value of 64 is useful. 
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Sound configuration 

Before configuring speech 
support for Navit, configure the external 
sound card. You have to stop the 
Broadcom module from loading and 
remove some Raspberry Pi-specific ALSA 
(Advanced Linux Sound Architecture). 
To do this, sudo-edit /etc/mod probe and 
comment out (i.e. prefix with a #): 


Full code listing 

* 

* 

r = requests ,get(api_req) 

requests, exceptions . RequestException 
return errstr 

WeatherClient.usefuldata(r . json()) 



e: 


snd-bcm2835 
Then run: 

sudo rm /etc/modprobe.d/alsa* 


Reboot for the changes to take effect. 
Use alsamixer to set the volume on the 
if it’s too quiet. 


M Down load a voice 

The speech synthesis software 
needs a voice and a proprietary 
binary. You can get both by completing 
the following steps: 


ini t__ (self): 

pygame, init() 

pygame . mi xe r , qu i t ( ) 

screen_info = pygame. display . Info() 

self. screen = pygame. display . set_mode((screen_info. current_w, 

screen_info. current_h)) 
pygame. display . set_caption(‘Car Launcher ) 
self . titlefont = pygame. font . Font (None, 100) 
self.wfont - pygame . font . Font(None, 30 ) 
self.w_text = None 

clean_b ac kgrour (self): 

background = pygame. Surface(self. screen. get_size()) 
self .background = background. convert () 
self .background. fill ( 00 , 0 , 0 )) 


sudo mkdir -p /usr/share/ 
mb r ola/voices/ 

wget http://www.tcts.fpms.ac.be/ 

synthesis/mbrola/dba/enl/enl- 

9809l0.zip 

unzip enl-980910.zip 
sudo cp enl/enl /usr/share/ 
mb rola /voices 

wget http://www.tcts.fpms.ac.be/ 

synthesis/mbrola/bin/raspberri_ 

pi/mbrola.tgz 

tar zxvf mbrola.tgz 

sudo mv mbrola /usr/local/bin/ 


Create speech script 

1%^ Navit supports speech by 
running an external script and passing 
the text to speak as an argument. 
Create one usins: 


text = self . titlefont . render( irPi Launchei , , (55, 255, )) 

textpos = text . get_rect() 

textpos . centerx = self .background . get_rect() . centerx 
self . background . blit (text , textpos) 

self . screen . blit(self . background , ( ,0)) 
pygame .display . f lip() 

main_menu(self) : 

self .btns = { isic' : None, NAV’ : None, ;ather’ : None} 

item„num = 1 
f key in self. btns: 

text = self . titlefont . render (key , , (255,255, )) 

textpos = text . get„rect() 

max_width - self .background . get_rect() .width / len(self . btns) 
center offset - max_width *0.5 


cd /home/pi/.navit 

wget http://liamfraser.co.uk/ 

lud/earpi/chime.wav 

touch speech. sh 

chmod +x speech. sh 


textpos . centery = self . background. get_rect() . centery / 2 

textpos . centerx = (max„width * item_num) - center„offset 

self . btns[key] - textpos 

self . screen . blit(text , textpos) 

item„num += 1 


Now edit speech, sh: 


pygame .display . f lip() 


#!/bin/bash 

aplay -r 44100 /home/pi/.navit/ 
chime.wav 

espeak -vmb-enl -s 110 ~a 150 
-p 50 “$1” 

FinaLly, test it with: 

. /speech. sh “Hello World” 


sell rect(self, rect, text): 

surface = pygame . 5urface( (rect. w, rect.h)) 
surface . fill( (0 , , 0 )) 

t = self . titlefont . render (text , 1, ( , , )) 

surface . blit(t , ( , 0 )) 

self . screen . blit(surface , rect) 

pygame .display . f lip() 
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You will need to write your 
own lau ncher for CarPi 



AboveThe pympdtouchgui front-end forthe 
music player is surprisingLy featureful 


Make it 
mobile 



It is definitely best 
to putthrs project 
together in a clean 
workspace so that 
you can clearly 
see what you’re 
working with and 
ensure everything is 
correctly wired and 
soldered, butthe 
point of the project 
isto make this setup 
portable so that you 
can put it in your 
car and use it on 
the road. You could 
instaLl everything 
intoasingLe, hand- 
made enclosure or 
customise a large 
bought one, or you 
could secure the 
various parts inside, 
for example, your 
gloveboxorcar 
doors. You’ll also 
need to power both 
the screen and your 
Pi with a power pack 
and ensure that 
the GPS antenna is 
fastened into a good 
spot for signal 


Configure Navit for speech 

1©^ The last part is simple. Edit the Navit config file again (/ 
etc/navit/navit.xml) and replace the following line: 



<speech type- 'cmd line” data- ‘echo ‘Fix the speech 
tag in navit. xml to let navit say:’ ‘%s’” cps-‘15"/> 


...with: 

<speech type-“cmdline" data- ‘/home/pi/, navit/ 
speech. sh %s” cps=“10” /> 


Now you can run Navit with DISPLAY=:0.0 navit and have 
fun experimenting. 


f Install the music player 

MPD is the music player back-end and pympdtouchgui 
is the front-end that needs installing manually: 




_ 

- 




sudo apt-get install mpd ncmpcpp 

wget http://www.spida.net/projects/software/ 

pympdtouchgui/pympdtouchgui-0.320.tgz 

tar zxvf pympdtouchgui-0.320.tgz 

cd pympdtouchgui-0.320/ 

sudo python setup. py install 

# Fix hard coded path in software 

sudo In -s /usr/local/share/pympdtouchgui/ /usr/ 

share/pympdtouchgui 


18 Copy music 


Sep (secure copy protocol) was used here to copy 
music. First get the Pi’s IP address by running ip addr. Then 


run sudo passwd to set a password for root. From a computer 
with music on, run: 

sep -r music_folder root@pi_ip„address:/var/lib/ 
mpd/music/ 

Then on the Pi, change the ownership of the music that 
you just copied: 

sudo chown -R mpd:audio /var/lib/mpd/music 

Update mpd music library 

Ncmpcpp is a command line client for mpd. Type 
ncmpcpp and press U to update the library. Press 3 to 
browse the library and check the music is there, and press 
Q to quit. Pressing 1 will select the help screen if you want 
to do more. 


Install awesome window manager 

Now you will need to write your own launcher for 
CarPi, which will run full-screen. To ensure every application 
is forced to full-screen, use awesome window manager in full- 
screen mode. 


sudo apt-get install awesome 

sudo rm /etc/alternatives/x-session-manager 

sudo In -s /usr/bin/awesome /etc/alternatives/x- 

session-manager 


When changing the default x-session-manager, awesome will 
be auto-started at boot instead of LXDE. If you reboot the Pi, 
awesome should then load up automatically. 
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Install the requirements 
for your launcher 

The launcher is going to use a weather 
API combined with location data 
from the GPS receiver to give weather 
updates when requested. The nicest 
HTTP API for Python is requests, which 
you can install by doing the following: 

sudo apt-get install python-pip 
sudo pip install requests 

Write the launcher code 

Creating the code itself is pretty 
self explanatory, but you can use our 
ready-made version by downloading the 
CarPi package from FileSilo.co.uk and 
extracting carlauncher/carlauncher.py. 


CarPi Launcher 
NAV Weather Music 


Start the launcher 
automatically 

Sudo-edit /etc/xdg/awesome/rc.lua and 
move awfuLlayout.suit.max.fullscreen 
to the top of the layouts list. Add the 
following to the bottom of the file: 

awful. util . spawn_with_shell(“/ 
home/pi/carlauncher/carlauncher. 

PY”) 

Now reboot again and the launcher 
should come up automatically. 


CarPi Launcher 
NAV Weather Music 

/ 


Future improvements 

y Jr si / i j 

fc*T There are a number of 

improvements that could be made 

to the base project at this point: 

• Make the launcher switch between 
applications rather than start them 
again each time 

• Make the launcher look better 
aesthetically with icons 

• Use Mopidy instead of M PD so you 
can use Spotify 

• Further Navit configuration to make 
it more featureful 

• An SSDor USB flash drive for storage 
to make things quicker 






Full code listing 

res (self): 
self . clean_background() 
self . main_menu() 
self. render_weather () 

—c it (self , path) : 
os , systenn(path) 


self . reset() 


der_weather(self): 

self.wtext == None: 


margin = 10 

y = self .btns[ ' NAV ] ,bottomleft[l] + margin 
t in self w„ text, split( \n’): 

line - self . wfont . render(t. rstripQ , 1 , (255,255,255)) 
line_rect = line.get_rect() 

line„rect.centerx = self . background, get_rect() . centerx 
line_rect.y = y 

self . screen. blit (line, line_rect) 
y += margin + line_rect. height 

pygame. display , flip() 

.even (self, events): 
e in events: 

e.type =~ QUIT: 
sys.exit() 

e.type == MOUSEBUTTONDOWN: 
pos = pygame. mouse . get_pos() 

btn„text, rect in self .btns. iteritems() : 
rect. collidepoint(pos) : 
self . select_rect(rect, btn_text) 
btn_text == “NAV : 
self .execute( ‘/usr/bin/navi ) 
btn_text =- “Music”: 

self. execute( usr / local/bi n/pyn pd touchgu i ) 

btn_text == “Weather 1 ’: 

self.w_text _ WeatherClient . update() 

self. reset() 


loop (self): 

clock = pygame . time . ClockQ 
self . reset() 


self . handle_events(pygame. event . get()) 
clock . tick(5) 


_name == “. jnain 

cl = CarLauncher () 
cl . loop() 
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Components list 


Raspberry Pi Model B+ 

3 DHT22 temperature- 
humidity sensors 

4 relay modules 
Outlet boxes 
LEDs 

2 Mini 5V blower fans 
2 2N222 transistors 
2 1 0K resistors 
100, 0.5W resistor 


The Raspberry Pi itself sits just beside 
the vivarium, processingdata from the DHT22s 












HOW I MADE: RASPIVIV 



So, what do you keep in the vivarium? 

Right now I have seven poison dart 

frogs - they’re frogs from South 
America that, in the wild, excrete poison 
alkaloids, but in captivity, because 
their diet is just fruit flies, they can’t 
produce any poison. They’re something 
I’ve been interested in for quite a long 
time. I think I saw them first when I was 
in grade school at a trip to the Denver 
zoo, and I just thought they were the 
coolest animals I’d ever seen in my 
life. I’ve wanted to keep them since 
then but the opportunity never came 
up “ they’re kinda rare - until I found 
a breeder on Craigslist who has an 
incredible collection and he breeds them 
to support his hobby. So right now I have 
a total of seven: two blue poison dart 
frogs, which 1 think could be a breeding 
pair, and I recently obtained five yellow- 
banded poison dart frogs. 

What kind of requirements do you have 
for the vivarium, then? 

The temperature is really important, 
which a lot of people have trouble 
with because your house temperature 
is going to be about the same as an 
enclosed box, give or take, as lighting 
can heat things up. But you have 
to maintain specific temperatures 
between about 75 and 85 degrees. 
The humidity is even more important 
because the frogs use the it to 
thermoregulate similarto how we sweat. 

So basically, what I needed was a way 
to monitor and regulate the humidity, i 
looked around online for a couple of days 
trying to come up with a solution - a lot 
of people use little timers, and there are 
a couple of systems that are made for 
this but they don’t do very much. 

What hardware did you use to make your 
own solution? 

Well, the Raspberry Pi is set up as a 
LAMP server. ! started playing around 
with the DHT22 temperature-humidity 
sensor - originally I just wanted to 
monitor that, the temperature and 
the humidity, but then I got into using 
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relays to control the lighting and it just 
progressed further and further. I was 
just making this for myself and I posted 
on a forum. Then a lot of people seemed 
really interested, so I said I’d clean 
things up and throw together a guide 
(see www.raspiviv.com). 

So the temperature and humidity 
sensors are read every 60 seconds and 
logged into a database. Using WiringPi 
and Adafruit’s DHT22 sensor (and the 
driver for it, which works really well), 
lighting is controlled by regular relays or 
relay modules, and the fan is just a basic 
transistor switch. The main idea behind 
the fan is that if the atmosphere is too 
saturated with water then the frogs can’t 
thermoregulate. So the database is read 
every five minutes, and when it reaches 
95% humidity it then kicks on the fan to 
blow in some fresh air. 

Do you SSH in to control all this or do you 
have a web interface? 

Yeah, there’s a whole web interface 
where you can check out the current 
readings. Check out the Demo section on 
my website and the first thing that pops 
up is my blue poison dart frog vivarium. 
It gives you the current temperature and 
humidity, and the readings for the last 
hour. If you click on the icon that looks 
like a grid of buttons (manual controls), 


you can manually control your lighting, 
any misting system or fans you have 
- essentially, for any component that 
you want to control, it’s just a matter of 
getting a relay module and wiring it up. 

Are you planning to upgrade the 
RasPiViv software at any point? 

I hope to. I started work on this in my 
downtime and got insanely busy, so 
unfortunately I haven’t been able to do 
a lot with it. I’m hoping to get some RF 
power outlets soon so that, rather than 
wiring up a little power outlet box, you 
can just use these prebuilt outlets that 
you plug into your wall. I am hoping to 
implement some wireless stuff and 
I’d definitely like to make it more user 
friendly, rather than people manually 
adding cron jobs to things. I’d like them 
to be able to do it through the browser 
interface, stuff like that. 

What you don’t see in the demo is that 
there’s also a login system - you can 
make an account and keep ft secure - so 
I want to give people that and I’ll run a 
tutorial for setting it up. I’ve been playing 
around with the Raspberry Pi camera 
module and hoping to include it, so now 
we have a Raspberry Pi 2 that is a lot more 
capable, it could potentially pull off some 
kind of live camera that you can watch as 
well as all the other stuff that it does. 


oooooo 
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is a marketing 
consultant, 
photographer and 
graphic designer for 
Wheaton Design in 
Northern Colorado. 
He enjoys [earning 
about electronics, 
creating automation 
projects, and 
contributing as 
much as he can to 
the Raspberry Pi and 
Linux communities 
that have made all 
thispossibLe. 

Like it? 

Fancy building 
your own Vivarium 
controller? Check 
out the excellent 
step-by-step guide 
on Nate's website 
that takes you 
from NOOBS to the 
humidity regulation 
cron job (bit. 
ly/1 HTKyeX), 



Lookingfor more 
inspiration for 
sensor-driven 
projects? There 
are some great 
ones featured on 
The Raspberry Pi 
Foundation blog, 
Like the Feeder 
Tweeter and the 
PiPlanter: 
bit.ly/1Ak37mu. 


L f The RasPiViv 
web interface 
shows you the 
temperature and 
humidity readings 
overtime 
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Left Extra breadboards are 
used here to keep the main 
breadboard as free from 
wires as possible 


What you'll need 

Latest Raspbian image 

rg s [ j Id e r r v r ■ i . o r £? / d o ' n n I o 0.0 s 

At least one breadboard 
Push buttons 
■ LEDs 

Female-to-male GPIO 
jumper cables 

Male-to-male GPIO 
jumper cables 


In this tutorial we combine electronics, music and 
programming knowledge to create a simple sampler with 
looping capabilities. The implementation used in this article has 
three drum sounds as the samples, but it is trivial to add more 
until you run out of GPIO pins. 

Before we start, I’ll cover some basic musical terms. Music is 
split into bars, There are a certain number of beats in a bar. This 
sampler uses the 4/4 time signature, which means there are 4 
beats in each bar. Tempo is the speed at which music is played, 
and it is measured in beats per minute (bpm). A metronome is an 
audible tone that is heard atthe start of every beat. 

Quantization is the process of aligning notes to beats, or exact 
fractions of a beat, and a quantization value is usually given in the 
form 1/8. This means that there are eight possible places in a bar 
where a note can be played. When the sampler is recording and 
a sample button is pressed, we store the sample at the current 
position in the bar with the accuracy of the quantize value. 
There’s a lot to cover, so let’s get started. 


Connect LEDs 

It# U The circuit diagram is an LED that can be turned on and 
off with a GPIO output. The orange wire is the connection from 
the GPIO output. This then goes through a 2200 resistor to limit 
the current draw to a safe level. This current flows through the 
positive leg of the LED and then back to ground. We need nine 
LEDs for this project. 








MAKE A RASPBERRY PI SAMPLER 


Wire up buttons 

<s :> The second circuit we need is a 
push button. The purple wire goes to a 
GPIO input. There is a 10KO pull down 
resistor to ground, which represents 
a logical 0. When the push button is 
pressed, the 3.3V supply representing a 
logical 1 is connected to the purple wire. 
The electricity takes this path because it 
has less resistance than the path to 
ground. We need two buttons for record 
and undo, and then as many buttons as 
you like for samples (three drum samples 
are provided). 


, p; Download samples 

Create a few folder for the 
project called pisampler. Then download 
and unzipthe sounds: 


mkdir pisampler 
cd pisampler 

wget http://liamfraser.co.uk/lud/ 
pisampler/sounds . zip 
unzip sounds.zip 


There will now be a folder called sounds 
with some samples in. The file format for 
samples is .wav audio, Microsoft PCM, 
16 bit, stereo 44100 Hz. Mono will work 
too. Any samples can be converted to this 
format with Audacity by exporting them as 
a .wav file. 


Full code listing 



Step 04 


import RPi.GPIO as GPIO 

import time 
import pygame 
import os 


beat„leds = [2, 3, 4, 1 ] 

bar_leds - [27, , 10, 9] 

record_led =11 

record = 19 

undo = 26 

debounce = 200 



Step 05 


class Samp (object): 

def init (self, pin, sound, sampler): 

self. sampler = sampler 
self. name = sound 

self, sound = pygame mixer. Sound(os path join( und , sound)) 

self. pin = pin 

GPIO. setup (pin, GPIO. IN) 

GPIO. add_event_detect (self pin, GPIO RISING, callback=self .playjbtn, 

bouncet ime “debounce) 


def play_btr (self , channel): 
self. sound. play () 
s = self. sampler 
if s. recording: 

s . recording_data[s . bar_n] [s . quantizer] . append({ 


Step 06 


class i ami Ler (object): 

def init (self, tempo ), quantize~54) : 

pygame mixer. pre_i nit (4 100, -16, , 51 ) 

pygame. init () 


s . loop_count , 
: self}) 


M Import required libraries 

Create a file called pisampler. 
py in your favourite editor. The first thing 
we need to do is import the required 
libraries and set some configuration 
values. A key option is debounce: the time 
to wait before a button can be pressed 
again to stop accidental presses from 
contact bounce. 


Create a sample class 

We’re going to use a class to 
represent each sample. It's going to need 
a few things: the pin that the sample 
button is connected to, the name of the 
sound file, and a reference to the instance 
of the sampler class. We haven’t created 
the sampler class yet, but the sample 
will need to be able to tell if the sampler is 
recording or not, and have access to the 
data structure that recordings are stored in 
to add itself to it if necessary. 

The other thing that we need to do is set 
the GPIO pin to an input, and add an event 
listener for when the button is pressed. We 
set callback (the function to be executed 
when the button is pressed) to a function 
called self.play_btn, which will play a sound 


self .quantize = quantize 
self. tempo = tempo 
self-recording = False 
self. recordjiext - False 


self .metronome = False 

self.met_low = pygame mixer Sound(os path join ( 
self .met_high = pygame . mixer . Sound (os , path join( 
self . met_low . se t_volume ( 1 . 4 ) 
self ,met_high set_volume(0.4) 
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self. samples = [] 


self . recording_data = [] 
for i in range(0, 4): 
bar_arr = [] 

for i in range ( , quantize): 
bar_arr . append([]) 

self, record ing_data append (bar_arr) 

GPIO. setmode (GPIO. BCM) 

for pin in beat_leds + bar_leds + [record_led] : 
GPIO.setup(pin, GPIO. 001) 

GPIO. setup (record, GPIO IN) 
GPIO.add_event_detect(record, GPIO RISING, 

cal lback=sel f record_next_ loop, 
bouncetime debounce) 
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Full code listing 


ep 06 


GPIO set up (undo, GPIO.IN) 

GPIO add_event_detect(undo, GPIO RISING, 

callback-self , undo_previous_loop , 
bouncetime debounce) 


Step 07 




(self) : 

irn self._tempo 


per_beat 


(self, tempo): 
self ._tenpo = teirpo 
self . seconds_per_beat = 

self . quantize _per_beat 
self . quantize_seconds 


0.0 / tenpo 

= self .quantize / 4 
self , seconds j>er_beat / self . quantize. 



)d (self, sample): 
self . samples . append (sannple) 


ng(self) : 
self, recording 


recordir (self, value): 
self ..recording = value 
GPIO . output(record_led , value) 

record_next_loop(self, channel) 
self . record next = True 


f _recording(self) : 

sample.dict in self . record ing^data [self . bar _n] [self . 


quantizer] : 


sarrple_dict[ 'loo| ] != self . loop.count 
sample_dict[ n ]. sound. play () 


lo_previous_loop(self, channel): 
len(self . last_recorded_loop) = 0 


■■jo ore 


JJ JL 


o undo 


i r i c ii j t - 


loop = self. last.recorded_loop pop() 

for bar in self. record ing_data: 
for quantize in bar: 
removes - [] 
for sample in quantize: 

if sample[ loop'] == loop: 
removes . append (sample) 

for sample in removes: 

quantize. remove (sample) 


Step 11 


do_leds(self, leds, n): 
count - 0 
Tor led in leds: 
if count — n: 

GPIO output (led , T rue) 


and add it to the recording data if we are recording. 
It will become abundantly clear how this works once 
we’ve written the sampler class. Note that the GPIO 
event handler passes the pin that the event handler was 
triggered on, hence the channel variable that is present 
but never used. 

The sampler init method 

Here’s the start of the sampler class. The 
last value in the Pygame mixer init is the buffer size. 
You might need to increase this to 1024 or higher if 
you have audio dropouts. We create some variables 
to store recording state. Metronome sounds are then 
added and their volume lowered. We also create a list 
to hold our samples in. 

We create nested arrays to represent recorded 
sample presses. There is an array for each bar. Each 
bar has an array for each possible quantize value. 
The default value of 64 gives us 64 possible places to 
store a sample hit per bar. 

Finally, we set up the LED pins, and the pins for the 
record and undo buttons. 

The tempo property 

\Jw The tempo variable is actualLy a property with a 
custom setter. This means when a value is assigned, it 
does a custom action. In our case, we need to calculate 
how often we need to check for recorded notes to play 
in the main loopthat we’ll write later. 

Helper functions 

There are a few helper functions in the 
class. One of them simply adds a sample to the list of 
samples. Another sets a variable to trigger recording at 
the start of the next loop. There is also a function which 
turns the red LED on when the recording variable is set 
to true. Now we’ll jump forward and take care of the 
main loop towards the end of the full code listing. 

Start the main loop 

The main loop doesn’t actually have to do 
any work at all to play sounds, as that’s done by the 
GPIO event handlers. The main loop is used to play the 
metronome, update the state about which bar/beat/ 
quantize we are currently on, update the LEDs and deal 
with recording if necessary. 

Before the loop, we create variables to track the 
state. The last recorded loop is a list that we will use 
as a stack. A stack is a last in/first out data structure, 
allowing us to undo recordings multiple times by 
removing each sample that was recorded when the 
loop count was the value on the top of the stack. 

If we’re at the start of a new beat then we use a 
function called doJeds that we haven’t created yet. 
As the LEDs work in the same way (a blockof four LEDs 
where only one is turned on), we can use the same 
function twice and just pass a different set of pins, 
and the index of the LED we want to turn on. We then 
call the do_metronome function which will play the 
appropriate metronome sound. 

We then do some recording logic which starts 
recording if we should be recording, and stops 
recording if we have just been recording, adding the 
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loop number to the last_recorded_loop stack. We 
increment the loop count after doing this. 


umm 

1 


jf 


Main loop continued 

This code is at the indentation level after 
the “while True:” statement. After dealing with the 
recording logic, we need to play any notes that have 
been previously recorded. We ll work out how to do 
that later on. After that, we can sleep until the next 
quantize change is due. Once this happens, we have to 
do logic that deals with the quantize and any related 
variables such as the beat or bar if necessary, either 
incrementing them or resetting them if necessary. 




Lighting LEDs 

The LED code is simple. It simply goes through 
each pin in the list you provide it with and lights up the 
appropriate LED, ensuring that all of the others are 
turned off. 


If 9 




The metronome 

L: ■> The metronome simply plays a high tone on the 
first beat or a lower tone on the remaining beats if the 
metronome variable is set to true. 

The recording code 

Looking back at the sample class we created at 
the start, you can see that if recording is enabled, and 
a note is pressed, then we add a dictionary to the list 
of samples for the current bar at the current quantize 
point. The dictionary contains a reference to the 
sample so that it can be played, and also the loop that 
it was added on so that it can be removed if necessary. 
The code for playing and undoing recordings can be 
seen below. 

Note that we directly play the sound rather than 
using the btn_play function so that we don't trigger the 
recording logic when playing recorded sounds. 

The pop function in undo_previous_loop removes 
the last thing that was added to the stack, which will 
be the loop count. We then go through every possible 
recording data point and remove anything recorded on 
the loop we want to remove. 

Finishing it off 

1 * 1 ? To finish it off, we need to add a main function 
where we load some samples in and then start the 
main loop. Remember that you need to run the code 
with sudo python2 pisampler.py because we need sudo 
to access the GPIO. Happy jamming! 


16 ? 


Possible improvements 

%# There are a number of improvements that 

could be made to the sampler. Here are a few to get 

you started: 

• A button to turn the metronome on and off 

• The ability to time stretch samples (such as chords) 
to fit with the tempo 

• The ability to pitch shift samples on the fly 

• Using a shift register to use less pins when lighting 
the LEDs, allowing more inputs 

• The ability to save recorded beats so that they can 
be loaded and played back 


Full code listing 


Step 11 


GPIO output (led. False) 


count += 1 


Step 12 


def dojnetronome 1 (self) : 
if not self metronome 


Step 09 


ME 



return 


self .beat n 


0 : 


self. met_high . play() 

* 

* 

self .met„low play() 


ru: (self): 

self .loop„count = 0 

self . last_recorded_loop = [] 

self.bar_n - 0 

self.beatji - 0 

self .quant ize_beatji = 0 

self .quantizer = 0 

while True: 

if self. quantize Joeat_n -- 0: 

self . doJ.eds(beatJ.eds, self. beat_n) 
self . do_leds(bar_leds , self . bar_n) 
self . dojnetronome () 


— v ana 


self. bar n — 




if self .quantizer 

i f self . record_next : 

self-recording = True 
self . recordjiext = False 
elif self-recording: 

self-recording = False 

self. last_recorded_loop . append(self . loop_count) 
self . loop_count +- 1 


self . play _recording() 

time. sleep (self . quantize_seconds) 

if self.quantize_beat_n == self quant ize_per_beat - 1: 
self quant ize_beat__n = 0 
self.beatji +- 1 

_L O ■ 

self . quant izejoeatji += 1 

if self .quantize_n = self quantize - : 

self quantizer = 0 

_L *i_j ■ 

self .quant izeji += 1 


_ A 
““ *T 


self.beatji 
self.beatji = 0 
self. bar ji += 1 
if self bar ji = 
self, bar n = 


4 

0 



_name == ' ma i n : 

sampler = PiSampler (tempo 140) 
sampler. add(SampleQ5, i :k01.wav' 

sampler add (Sample (06 , nar e0 1 wav 

sampler. add (Sample ( 13, lhat01 .wav 
sampler. metronome - True 
sampler. run () 


sampler)) 

sampler)) 

sampler)) 
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The Raspberry Pi has been used in a plethora of 
applications in hardware, software and some 
quite unbelievable combinations of the two. From 
record-breaking space flights to automated bartending 
devices and much more, there are thousands of Raspberry Pi 
projects that, over the last two and a half years, have shown 
what a capable little Linux box this is. 

The BitScope Micro is certainly no exception and when you 
couple it with your Raspberry Pi you have a very powerful, 
pocket-sized oscilloscope that also features a whole 
host of other functionalities, such as a waveform and clock 
generator as well as a spectrum and logic analyser. Best of 
all though, the whole setup {including the Raspberry Pi itself) 
comes in at well under £ 150 . 

Requiring no external power source, the BitScope Micro is 
also water resistant and so is perfect for either home or lab 
use. It is fully configurable and user programmable in Python, 
C++ and more, and can even continuously stream data to disk. 



Grab your BitScope 

" * I If you have not already done so, you need to go and 
order your shiny new BitScope Micro (directly from BitScope 
or from one of their worldwide retailers). If you are serious 
about electronics then you need a good oscilLoscope, so it 
is truly worth every penny! Once it arrives, you should be 
greeted with the neatly packaged box pictured above. 



4 
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A& Open up the box 

Once you have received your BitScope Micro and 
opened up the box for the first time you should find all of the 
pictured items inside (if you get any extras, then it is obviously 
your lucky day). The main contents are the BitScope Micro 
itself (with mini USB cable preattached) and a set of ten 
test clip grabbers. There is also a variety of documentation 
containing a large amount of product info and guidance. 

Update your Raspberry Pi 

w As with almost every project you undertake on the 
Raspberry Pi, it pays dividends to make sure your operating 
system is updated to the latest stable version, as this can save a 
lot of hassle further down the line. To do this, open an LXTerminal 
session and then ty pe: 
sudo apt-get update 
sudo apt-get upgrade -y 

Then wait patiently for the upgrade process to complete. 


BitScope Pi Oscilloscope 



The BitScope Raspberry Pi Oscilloscope 



Tiny, just lik 





M Locate the BitScope Software 

Now your Raspberry Pi is all up to date you need 
to acquire the BitScope DSO (digital storage oscilloscope) 
software. This is not yet available as a Raspbian package, 
but it is very easy to install anyway using the downloadable 
DEB file. Visit www.bitscope.com/pi and click on the 
Download link at the top. 






Download the software 

The previous step should have brought you to the 
BitScope Downloads page. From here you need to download 
the top item in the list, BitScope DSO 2.7 (beta), and save it to 
the /home/pi directory on your Raspberry Pi so you know where 
to find it later. On some browsers the file will automatically 
download to the /home/pi/Downloads directory. 


I n stall the software 

Now we have downloaded the package, the easiest 
way to install the software is to open an LXTerminal session 
and then run the following code... 

sudo dpkg -i bitscope-dso_2.7.EA17H_armhf.deb 
...or the equivalent version for newer software. You should see 
lines of output as the installation progresses. The BitScope 
DSO software then appears in the main menu under Other. 

Overclock your Raspberry Pi (optional) 

The BitScope software will run fine on a Raspberry Pi with 
default settings, however it can be a bit slow to respond. Open 
an LXTerminal session and type sudo raspi-config. In the menu, 
select option 7 Overclock. Click OK on the following screen and on 
the next one select Turbo. Click OK and then you should see some 
code run. Once this completes press OK and then you are brought 
back to the main raspi-config window. Select Finish at the bottom 
right, and then select Yes to reboot your Raspberry Pi. 




oveThe BitScope 
Micro comes 
complete with 
test dip grabbers 
and a whole lot of 
documentation 


Multiple 

platform 

support 


One of the best 
things about the 
BitScope Micro 
(as weLLas its 
big brother, the 
BitScope BS10U) 
is that it's capable 
of running on a Pi 
and on any Linux, 
Windows or Mac 
OS X device with 
a USB port The 
graphical Uf is 
identical on each 
of these devices so 
its easy to switch 
between them. The 
BitScope Micro 
should also work 
with smartphones 
capable of USB on- 
the-go connections, 
butthereisno 
software available to 
take advantage 
of this yet. 
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bov We’re using the BitScope Micro BS05 
i n this tutorial - the same model that you can 

win in the competition 


Hardware 

upgrades 

One of the best 
things about the 
BitScope Micro 
is that it runs on 
exactly the same 
software as the 
more capable 
hardware in the 
range. This means 
if at some point in 
the future you feel 
the BitScope Micro 
is not enough for 
your needs, you can 
quickly and easily 
upgrade to better 
hardware with no 
hassle, and no need 
to Learn any new 
software! 



^0 Overclocking -part two 

W^Is# Overclocking can sometimes cause instability on your 
Raspberry Pi or an inability to boot at all. If this happens, you 
can press and hold the Shift key on your keyboard once you 
reach the above splash screen to boot into recovery mode. 
You can then re-do step 7 at a lower overclock setting and 
repeat until you find the highest stable setting. 

Plug in the BitScope 

W Now that the software has been successfully 
installed on your Raspberry Pi, we can get started with the 
BitScope, If you are using a Model A or B Raspberry Pi without 
a USB hub then I would recommend turning the Raspberry Pi 
off before attaching the BitScope or it may crash. The B+ 
should be fine with plug and play. 


Overdock can 
sometimes 
cause instability 


1 Familiarise your self with the software 

li The image on page 33 shows the screen layout of the 
BitScope DSO software. It is fairly intuitive, and is similar to 
other physical or virtual oscilloscopes. The largest part is the 
main display window. To the top-left is the trigger window (this 
changes to wave control if selected). Under the main window you 
have the analog input channels and various trim adjustments. 
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Load the BitScope DSO 

Now you can navigate to the BitScope DSO software in 
the menu, This should load a spLash screen with two options 
- POWER and SETUP. Click POWER and then OK on the pop- 
up information box. After a minute or less, the BitScope DSO 
main screen will load and you should see some lights on the 
BitScope start to flash. 


1 Familiarise yourself with pinout 

l' * The image above shows the BitScope Micro pinout 
diagram. There are a total of ten pins with two of them being 
ground pins (GND). The remaining eight pins can be configured 
as logic pins and four of them also have different functions - 
L4 is also a waveform generator (AWG), L5 is a clock generator, 
(CLK) and L7 and L6 relate to CHA and CHB respectively. 
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3D 




Perform a sample experiment 

The easiest way to test whether or not your BitScope is 
working correctly is to connect one of the test clip grabbers to 
the analog input CHA on the BitScope. Connect the other end 
to physical pin two on your Raspberry Pi and adjust the scale of 
the y axis to 2V/div. You should then see an output in the main 
window of around five volts. 



M Use different waveforms 

The BitScope can generate its own waveforms. Connect 
a female-to-female jumper cable between CHA and L4 (AWG). 
On the right-hand side of the DSO interface, select Wave and 
then a wave should appear in the main screen. Change the x 
axis to IOOus/Div and the y axis to 500mV/Div. Right-click on 
the yellow OFFSET button and select MEDIAN. The wave should 
now fill the main window as in the above screenshot, You can 
adjust various parameters of the waveform in the wave control 
panel top-left and can also change to step (square) or ramp 
(saw-tooth) waves instead of tone (sinusoidal). 


Experimenting with your body 

U Another interesting (but fairly simple) thing to try is 
measuring electrical signals from your body. Set the vertical 
axis to IV/Div and horizontal to 20ms/Div. Then plug in one of the 
probes to CHA, pull back the grabber end and touch it with your 
finger. You should then see a sine wave on the screen. Bizarrely, 
this wave is actually radio waves emitted by your mains electrical 


wiring which are then being picked up by your body (which is 
acting as an antenna). This is why the wavelength of the signal 
you see is approximately 50 to 60 Hz. 

1 Programming your BitScope 

The BitScope DSO and other available software (BitScope 
Logic and BitScope Chart) are very powerful applications for a lot 
of experimentation. However, in some more complex monitoring 
environments they may not offer enough flexibility. The good 
news is that you can program the BitScope in C/C++, Python or 
Pascal usingtheir programming API. 


Above The 

experiment uses 
your body as an 
antenna to pickup 
radio emissions from 
your house 




F Further experiments to try 

This tutorial has shown only a small fraction of what the 
BitScope Micro is capable of. As seen in the above image it can 
also be used as a spectrum analyser along with a whole host of 
other functionality. Perhaps for your next experiment you could 
measure the resistance of your body by comparing the voltage 
drop across your body with that of a known resistor. Or you could 
try probing your 12C or SPI connections to see how they work, ifyou 
ever run out of ideas, then why not visit the BitScope website and 
start experimentingfurther! 


Mains 

electrical 

frequency 



We looked at a signal 
from your body 
caused by radio 
emissionsfrom the 
mains power supply 
in your home. In 
Europe the mains 
frequency is 50 Hz 
and typically with 
a voltage of 230 or 
thereabouts. In USA 
and some parts 
of Asia, the mains 
frequency is 60 Hz 
with a typicaL voltage 
of 110. Most modern 
electrical equipment 
is therefore capabLe 
of operating at either 
voltage or frequency. 
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Popper buttons Beneath 

the fingers are small metal discs that 
can be activated just by a touch. Each 
button has been given a new function 


Camera module This has been 

embedded intothefabric on the back 
of the glove, so photos can be taken by 
raising a hand and touching a button 



Components list 

Raspberry Pi Model A+ 
Raspberry Pi camera module 
5 Short cables 
5 Popper buttons 
USB mobile phone battery 
USB Wi-Fi dongle 
Energenie add-on board 
Golf glove 


l1 


Forthe next version, Dan may add a palm 
button fora hierarchical menu structure to 
navigate the functions on each finger-button 

Now he’s done the social media (see 
issue 14S) and the home help modules, Dan 
will make a start on the fitness module 













What physical modifications have 

you made since we last spoke? 

The glove is more portable - 
previously, the Raspberry Pi was in the 
wearer’s pocket and you had the long 
CAT5 cables attached the glove. This has 
all been stripped back and several steps 
enabled this. Firstly, was the use of fabric 
clothes poppers to replace the tactile 
switches. These are metal and when one 
makes contact with a ground popper on 
the thumb, it creates the circuit. It has 
meant that the same functionality is 
achieved with five wires as opposed to 
the previous ten wires. Secondly, I have 
moved from a B+ model to the A+ model, 
which has meant that the Raspberry Pi 
is now small enough to be mounted on to 
the glove itself. Now the wires only need 
to run from the fingertip to the wrist. The 
camera module is also embedded within 
the glove. The lens is exposed through the 
glove but the rest of the camera is now 
housed within the fabric of the glove. You 
have to be a little bit more careful when 
you take the glove off, but the overall 
pay-off is that the glove is now lighter 
and more compact. The power comes 
from a small USB mobile phone charger 
which gives about six hours running time, 
depending on how much you use it for. 

What new functions does the rebuilt 
glove have? 

It was always the plan to develop the Pi 
Glove with ‘modules’ for various uses, 
starting with home assistance. Imagine 
if you did or maybe do struggle with a 
disability and you wake up in the night 
- the Pi Glove now enables you to check 
the time, which is read out, and a light 
can be turned on with a simple finger 
movement. If required, an emergency 
text can be sent to a carer, family 
member or the provider of other medical 
assistance. The fourth button enables 
the Pi camera, which takes a picture of 
a sign, for example. OCR is then used to 
recognise and store the text, which is 
then read back to you. 

I decided to add the Pi camera around 
the back of the hand area - this linked 



Check out Dan Aldred's new home help module 


in well, enabling a more mobile use of Are you currently developing any rtew 

the camera; it can now be positioned modules for the future? 

in a direction that the user wants, is The current module I am working on is 

more accessible and you could even fitness-related and will allow the wearer 

take a selfie! The main reason for this to take their heart rate, change their 

change was to enable ‘on the fly’ optical music and upload the details of a run 

character recognition. I installed a to their chosen social media site. This 

Python OCR library and, combining will be on the fly with no need to stop 

this with the image taken from the Pi running or whatever sporting activity 

camera, the software can identify the you are doing. Just touch the buttons 

text within the picture. This text is then and your workout music changes, oryour 

fed back to the console and easy-Speak heart rate is read and then converted to 

reads out the text. I tried various file a string and read back to you through 

formats - JPG seemed to work well, your headphones. I find that current 

Also, changing the picture to black and apps on phones and watches disrupt 

white to pick up detail and differentiate your workout - ! don’t want to have 

between the text, had improved results, to stop running to check my pulse or 

There were issues with it not identifying change the music, 

text in low light, and also if the text was I was looking at the idea of Unking the 

the wrong way round or upside down, glove functionally to a smartphone but 

Finally, changing the saturation and this, I feel, would be moving away from 

increasing the sharpness produced the original aim, which was to remove 

usable results. the cumbersomeness of the phone - 

The emergency text on the second having to unlock it, load an app, wait for 

button makes use of Twilio, the web- the camera to prepare itself. The glove 

based communication API, which enables you to click and go. 

enables the user to send a pre-written 

message requesting assistance. This What would you like to do for the third 

could be adopted by others, such as iteration of Project New York? 

the police or fire brigade, for use in I was introduced to the Micro Python 

dangerous situations. The current time Pyboard (micropython.org/live), which 
is also added to the text. has a range of features built in and is 

To turn the lights on I used an add-on smaller, making it more suitable as a 
board by Energenie. Once installed you wearable component. The Micro Python 

can use it to control up to four simple board is a small electronic circuit board 

Energenie radio-controlled sockets that runs Micro Python on the bare 

independently, using a small program. metal, and gives you a low-level Python 

The add-on board connects directly to operating system that can be used to 

the GPIO, which can be controlled as take control of all kinds of different 

either input or output tines under your electronic projects, 

software control. A Python library is also The battery size is also an area that 
available to program the sockets. I simply could be reduced - I am looking into this, 
mapped the ‘on’ state to the click of the The smaller that all these components 
button and it turned the light on - from are, the more natural the glove will feel 
your fingertips! when it’s being worn. 

F The camera takes a picture of a 
sign. OCR recognises and stores 
the text, which is read back to you 



acurnculum leader 
for Computing and IT 
at a comprehensive 
school and the 
Lead co-ordinator 
forComputing 
At School As 
a Raspberry Pi 
Certified Educator, 
Dan promotes the 
use of the Pi in 
education and as a 
tool for learning. 

Like it? 

To Learn more about 
the redesigned 
Raspberry Pi Glove 
and the current 
home help module, 
checkout Dan's 
YouTube video (bit. 
ly/IHVQTYA) and 
the project write-up 
(biUy/19xgQyC), 

Further 

reading 

If you're interested 
in settingup 
optical character 
recognition foryour 
own sign-reading 
Python projects, 
checkout Dan’s 
guide over at 
TeCoEd (Teaching 
Computing 
Education): 
tecoed.co.uk/ 
python-ocr.html. 


r ^ 
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Update the Raspberry Pi 

This project is designed for the Raspberry Pi 2 which 
requires the updated operating system, although it is compatible 
with the Raspberry Pi B+too. First ensure that the software is up 
to date - open the LX Terminal type: 

sudo apt-get update 

sudo apt-get dist-upgrade 

sudo apt-get install raspberrypi-ui-mods 



with GPIO pins and setting up buttons, jump straight to Step 8 


up a test button, use GPIO pin 17 - this is physical pin number 11 
on the board. The other wire connects to a ground pin, shown by a 
minus sign (the pin above GPIO pin 17 is a ground pin). 


What you'll need 


■ Raspberry Pi 2 

4 x 6mm tactile buttons 
Female-to-f emale jerky 
Terminal blocks 
A glove 
Router 

■ 2x CATS cables 


Many of you will be avid fans of the game Minecraft. In 

schools it is fast becoming a motivational teaching and 
learning tool, useful in areas such as programming, creating 
logic gates and setting up a network. 

This project is framed around creating a simple networked 
Minecraft game where one player chases the other and 
tries to hit the block they are standing on. The real hack is 
programming a ‘power glove’ that enables you to assign power 
moves to each button. These powers can then be deployed 
and used to slow down the other player and get yourself out 
of sticky situations - check out the video at bit.ly/ICQSmHS! 
The real beauty of this hack is that you can then create and 
customise your own power moves. The possibilities are 
endless, limited only by your imagination, if you’re confident 


Connect a button to the Raspberry Ps 

Take one of the buttons and connect a wire to each 
contact, then take the other two ends and connect to the Pi. You 
may find this easier using a female-to-female connector. To set 
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Test that the button works 

Use this test code to ensure the button is functioning 
correctly. Once it is, the same setup method can be used 
throughout this project. To ensure the buttons are responsive, 
use the pull-up resistor with the code GPIO.PUDJJP - this will 
ensure that multiple touches aren’t registered on each button. 
Using Python 2.8, type in the code below, then save and run. If 
working correctly, it will return the message ‘Button works’. 

import RPi.GPIO as GPIO 


PiGlovePowerMoves . py 

I import time 

from mcpi import minecraft 

me - minecraft. Minecraft. create (“192. 168. 1.211”) 
import RPi.GPIO as GPIO 



GPIO. setmode(GPIO.BCM) 

GPIO. cleanup() 

GPIO. setup(17, GPIO. IN, GPIO.PUDJJP) 
T rue : 

GPIO input(17) == 0: 

“Button works” 



M Create a power move 

Now to create your first power move. The glove and code 
are structured in such a way that once the basic code template is 
set up, you can create your own power moves and assign them to 
each button, keeping both your ideas and your gameplay fresh. 
The first power move you will program enables you to place a wall 
of TNT between you and the player trying to catch you, They have 
a choice to go around the wall or blow it up, but it will slow them 
down. In a new Python window, type the code below and save the 
program into the home folder: 

import time 

Fi newel (): 

me. postToChat (“Firewall Placed”) 

TNT = 46,1 

x, y, z = me. player, getPos() 
mc,setBlocks(x-6, y, z+2, x+6, y+10, z+3, TNT) 
time,sleep(10) 


True: 

FirewallQ 


Open Minecraft 

The updated version of the Raspbian OS comes with 
Minecraft pre-installed, it can be found under Menu>Games 
- so load it up. If you have used the Minecraft: Pi Edition before 
you will be aware that it runs better in a smaller-sized window, 
so don’t make it full screen. You may prefer to adjust and arrange 
each window side-by-side to enable you to view both the Python 
code and the Minecraft game atthe same time. 


GPIO. setmode (GPIO . BCM) 

GPIO.cleanup() 

GPI0.setup(17, GPIO. IN, GPIO.PUDJJP) 

dTVtnj j |r“'| A I—/ f | Ai LJ p f ►— [\l It— "1 I 1 ” 12k I 

GPIQ.setup(18, GPIO. IN, GPIO.PUDJJP) 
GPI0.setup(9, GPIO IN, GPIO PUDJJP) 
GPIO.setup( , GPIO. IN, GPIO PUDJJP) 
GPIO. setwarnings (False) 


Fi rewall () : 

me postToChat (“Firewall Placed”) 

TNT = 46,1 

x, y, z = me. player, getPos() 
mc.setBlocks(x-6, y, z+2, x+6, y+10, z+3, TNT) 
time.sleep( ) 


Lay_Lava(): 

Lava =10 
check = 1 

me. postToChat (“Lava Deployed”) 
check == I : 
time,sleep(0.2 ) 
x, y, z = mc.player.getPos() 
mc.setBlock(x-l , y, z. Lava) 
check = 0 


Medium, (): 

time. sleep ( 0 . ] ) 
me . postToChat (“Mega- Jump”) 
x, y, z = me. player ,getPos() 
me. player. setPos(x, y+15, z) 
time.sleep(l) 


MegaJVar -r_Puddlt (): 

me. postToChat (“Mega Water Puddle") 
time. sleep (9. ) 

WATER = 9 

x, y, z = me. player ,getPos() 
me setBlocks(x- , y, z-4, x-1, y, z+4, WATER) 
time. sleep (1) 


GPIO pins 



GPIO pins area 
physical interface 
between the Pi and 
the outside world. 

At the simplest 
level, you can 
thinkofthemas 
switchesthat you 
can turn on or off 
(input) orthatthe 
Pi can turn on or off 
(output), The GPECX 
BCM option means 
that you are referring 
to the pins by the 
“Broadcom SQC 
channel” number. 
GPIO.BOARD 
specifies that you 
are referring to the 
pins by the number 
of the pin and the 
plug- the numbers 
printed on the board. 
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IP address 



Most home 
networks will use 
IP addresses that 
start with 192.168.1 
and then a number 
up to 255. An old 
router will assign 
these IP addresses 
automatically. If 
the router has Wi-Fi 
then players can 
also conn ect to 
multiplayer using a 
USB Wi-Fi dongle; 
you are setting up 
a LAN (Local Area 
Network). 




Engage the firewall 

• Start a new Minecraft game, then go to the Python 
program and press F5 to run it You may need to press the 
Tab key to release the mouse from the Minecraft window. The 
program will place a 12 x 10 wall of TNT behind the player every 
ten seconds - you can blow them up but the Pi might lag. 


f Assign the power move to the button 

# Now you have a working button and a power move, you 
can combine these two together. Basically, when you press the 
button the power move will deploy. Once this is working you can 
then set up the other three buttons with the same method. Open 
a new Python window and type in the code below - save the file 
in the home folder. Start a Minecraft game as shown in Step 6 
and then run the new program. Every time you press the button 
you will place a TNT firewall. 


import time 

from mcpi import minecraft 

me = minecraft .Minecraft, create () 

import RPi . GPIO as GPIO 


GPIO setmode (GPIO . BCM) 


GPIO setup(17, GPIO. IN, GPIO.PUDJJP) 


Firewall (): 

me . postToChat (“Firewall Placed") 

TNT = 46,1 

x, y, z = me. player ,getPos() 
mc.setBlocks(x-6, y, z-2, x+6, y+1 , z-1, TNT) 


T rue : 

GPIO input(17) = 0 : 
Fi rewall () 


Below If you want to 
get fancy, try using 
the popper buttons 
that Dan added to 
his Pi Glove 2 project 


AA Set up further buttons 

Once you have one button working the next step is 
to set up the other three using the same method from Step 2. 
Take the button and connect the two wires to either side. At this 
point you can add all three buttons and test them individually 
for connectivity. Connect each set of button wires to the GPI0 17 
and run the firewall program, If the firewall power move builds 
on each click of the button, the connections and buttons are 
working and you’re ready to attach the buttons to the glove. 



Create the glove 

V* 7 Take your glove and attach the four 
buttons to the fingers on the glove. There are a 
number of ways to do this: glue the button 
on, sewthem in, stick them with double- 
sided tape - the choice is up to 
you. Wires can be hidden or on 
display, depending on your 
preferences and how you 
wantthe glove to look. 


Connect the wires 

1^^ Now you are ready to connect the wires to the Raspberry 
Pi to enable all four power moves to be used. Take one end of 
each wire and connect them to the respective pins, as shown 
below. The other end of the wire is placed into a ground pin. Note 
that the RPi.GPIO pin numbering system is used here rather 
than the physical pin number on the board - for example, GPIO 
pin 17 is physical pin number 11. The following pins are used: 

GPIO 17, pin 11 on the board 
GPIO 18, pin 12 on the board 
GPIO 9, pin 21 on the board 
GPIO 4, pin 7 on the board 


Set the network up 

1 i To interact with other players in the Minecra ft world you will 
need to set up a networked multiplayer game. This is simple and 
can be achieved using an old router. Connect each Raspberry Pi 
via an ethernet cable to the router and then backto the ethernet 
port on each Raspberry Pi. Turn on the router and wait about 
30 seconds for the IP addresses to be assigned. Now load up 
Minecraft and one of the players will start a new game. 


scanning for Local Hat work Gan as,,* 


Steve Fi 
1 ' 92 , 168 . 1.111 


Back 


Run the game! 

4 After the game has loaded, the other connected player 
will see an option to “connect to a multiplayer game”, usually 
called Steve, The player selects this option and the networked 
game will begin. You will be able to see two ‘Steves’ and the 
Minecraft chat will inform you that ‘Steve has joined the game’. 
Open Python and the glove code, press F5 to run and you will be 
able to seethe power moves being deployed. 



Interact in another player’s world 

l Y w You’Ll notice under the current setup that if the Pi GLove 
is connected to the game and you use one of your power moves, 
it will only appear in your Minecraft world and not in the other 
players. This isn’t great, as the power move is supposed to stop 
the other player! To resolve this, find the IP address of the other 
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Raspberry Pi, then enter this IP address into this line of code: me 
= minecraft.Minecraft.create( ). For example, mc-minecraft. 
Minecraft.create(“1 92.1 68.2.234”), filling the empty brackets 
with the IP address of the other Raspberry Pi within your game. 
Remember that this is the IP address of the other player’s 
Raspberry Pi and not your I 5 address. 


M Find your IP addresses 

To find the IP address of a Raspberry Pi, load the LX 
terminal, type ipconfig and press Enter - the address will 
be displayed on the line that begins int addr:. This is the 
number that you enter into the me = minecraft.Minecraft, 
create(“192 .168.2. 234”). Remember on the Glove Raspberry Pi to 
enterthe IP address of the other players Raspberry Pi, not yours. 

Run both programs 

• No game would be complete without some healthy 
competition and strategy. A second program is deployed by the 
other player on the network which tracks and registers if they 
catch or hit you. The program checks the block that they have hit 
and compares ittothe players location. 



Test for hits 

Il3r To check if the other player has hit you, run the second 
program on the Raspberry Pi of the player who is doing the 
chasing. The program basically finds the other ‘glove’ players 
current position and stores it in a variable. It then compares 
the position that you hit with your sword, recording and storing 
this too. The program then compares the values, if they match 
then you have hit the other player and have won the game. I 
not, get ready for a tirade of power moves. Note that in order to 
monitor where the other player is, you must set the code line 
mcl = minecraft.Minecraft.create( ) to the IP address of the 
Glove Raspberry Pi; for example, mcl = minecraft.Minecraft, 
create(“1 92.1 68.1 .251”). 


I The program compares the values, 
if they match then you have hit 
the other player and have won the 
game. If not, then get ready for a 
tirade of power moves 

PiGlovePowerMoves . py rt.) 


lava_check = 0 

mc.postToChat(“Minecraft Power Glove Enabled”) 
while True: 

GPIO input(17) == 0: 

Firewall 0 

GPIO input ( ) == 0: 

Lay_Lava() 


tfGPIO. output (18, GPIO. LOW) 
GPIO input ( ) — 0: 
Mega_Jump() 

GPIO input (4) == 0: 
Mega_Water_Puddle() 


“Error” 


YouWereHit.py 

import time 

from mepi import minecraft 

mcl = minecraft, Minecraft. create(“192. 168. 1.245") 


me = minecraft.Minecraft. createC) 
mc.postToChat(“###Here I cane”) 
Hit = 1 

Hit == 1: 


Game on 

Now you are ready to play, check again that the IP 
addresses are set for the other Raspberry Pi and not your 
own. Build a new Minecraft world and start a new game on the 
Raspberry Pi with the player who is chasing. When loaded, the 
glove player joins the multiplayer game - this will be called Steve 
(see Step 11). When loaded, you should see both players in the 
world. Then run the ‘Pi Glove power moves’ program, and on the 
other Pi run the ‘You hit me program’. Don’t forget to set the IP 
addresses to each other Raspberry Pi. 

Once set up, you can modify the power moves, use different 
blocks and add new moves. You could create a timer and a 
scoring system to track which player can survive the longest. If 
you are feeling adventurous, you may want to make another 
Power Glove, one for each player. 


stood„x, stood_y, stood_z = mcl. player getTilePos() 
time. sleep(3) 

blockHits - me. events pollBlockH its () 
if blockHits: 

for blockHit in blockHits: 

stood_z == blockHit. pos.z and stood_y == blockHit. pos.y+1: 
me. postToChat (“I got you”) 
time. sleep ( ) 

me . postToChat (“###GAME OVER###”) 
time . sleep(i) 

Hit = 0 

me. postToChat (“###Re start Hit Code”) 
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What youH need 


Breadboard & wires 


1 1 16x16 LED Matrix 

■ 2x74HC238 

■ 2X74HC244 

■ 16x 220 Ohm Resistor 




Driving LEDs in an efficient fashion is a science of its own. 

The common availability of single-board computers has put 
the necessary technology within reach of everyone. 

When dealing with LED displays, two different systems 
must be considered. We will focus on traditional matrix- 
based systems made up of one or more LEDs. Their 
affordable nature makes them ideally suited to classic display 
applications: they communicate currency prices, provide 
stock-brokers with updates from the trading floor and have 
even been used as basic displays for primitive oscilloscopes. 

Finally, we will also provide you with an overview of 
electronic basics. This tutorial is a bit more advanced than the 
ones we’ve featured up until now, and it’s also worth noting 
that we're going to be programming with C rather than Python. 
Follow along usingthe code listing an nos. 


Think about LEDs 

Standalone LEDs are primitive - they light up once 
current flows through them. Driving a few LEDs is as easy as 
connecting them to GPIO pins along with a resistor. Sadly, this 
method becomes wasteful once more than a few of them get 
i nvolved — driving 16 diodes ties up 16 pins. 

Arrange your diodes 

Methods were devised to reduce the number of pins 
needed. Matrix-based systems are resilient to individual 
diode failures, and provide a pin-to-LED ratio of n=(n/2) A 2. The 
following steps assume a 16x16 LED matrix which is made 
up according to Figure A. Since LEDs permit current in only 
one direction, you can enable a single LED by bringing the 
corresponding pins high and low. 
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BUILD A COMPLEX LED MATRIX 


B 


Our LED model has 
a total of 32 inputs, 
which overwhelms 
older versions 
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Above The extended version of this schematic is inside FileSilo.co.uk 
- just sign in and head to the issue #1 51 page 




Harness the MUX 

f Our LED module has a total of 32 inputs, which 
overwhelms older versions of the RPi, The first way to restrict 
their number comes in the shape of the 74HC238, a component 
described as a 3-to-8 line decoder/demultiplexer. Its function is 
described in the Figure Bimage on the next page. 

Separate concerns 

Chip two goes by the name of 74HC244, which is 
described as an octal buffer with tri-state capability. Tri-State 
outputs can physically disconnect themselves from the bus 
line. This permits you to tie their outputs together without 
fear of short circuits. As long as all but one chip are in tri-state 
mode, no current can flow between high and low output pins. 


Round them up 

Four GPIO pins control the currently-enabled ‘line’ 





of the display. Three pins configure the address which is to 
be emitted, while the signal emitted from the fourth pin is 
connected to the activity inputs. This ensures that but one 1C 
is active, The 74HC244 ensures that but one of the two groups 
is active at any given time. 

Configure the pins 

We used a library from Flussam Al-Hertam’s 
Hertaville blog (hertaville.eom/2014/07/07/rpimmapgpio). 
The first step involves setting output functions. As the GPIOs 
are set to outputs, the tri-state feature might connect the 
internal state to the output pins of the 1C. This could lead to 
internal shorting if the output is not turned off. 




Full code listin 


Step 12 


Step 07 


Step 08 


{ 


> 


{ 


_which, mroapGpio* _where) 


( which&l) 


{ 


} 


{ 


> 


{ 


} 


{ 


} 


_where->writePinHigh( PINAO ) ; 


_where->writePinLow(PINAO ) ; 
( which & 2 ) 


where- writePinHigh ( PINA1 ) ; 


where writePinLow< PINA1 ) ; 


(_which&4 ) 


{ 


> 


( 


} 


where- writePinHigh ( PINA2 ) ; 


where - writePinLow{ PINA2 ) ; 


{ 


} 


{ 


} 


(_which&f> } 

where- -writePinHigh ( PINA3 ) ; 


where ->writePinLow{ PINA3 ) ; 


( 


which, mmapGpio 1 where) 


_where->writePinHigh{PIMCSO) ; 

where ->writePinHigh(PINCSl) ; 
if (_which==0 ) 

{ 

_where >writePinLow(PINCSO ) ; 

} 


{ 
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Power the MUX 

Create a convenience function taking an address 
ranging from zero to 15. tt is converted into pin outputs for our 
3-to-8-demultiplexer. The effect of this is that ail but one of 
the sixteen rows is to be supplied with energy. 


Full 


Step 11 


code listing 

where~>writePinLow(PIMCSl ) ; 


> 


{ 


> 


which, mmapGpio* where) 


( _which& 1 ) 


{ 


} 


{ 


> 


{ 


} 


{ 


} 


where- writePinHigh ( PINDO ) ; 


_where->writePinLow(PINDO ) ; 
( which&2 ) 


where->writePinHigh ( PIND1 ) ; 


_where->writePinLow(PINDl ) ; 


{ 


} 


( which&4 ) 


_where ->writePinHigh ( PIND2 ) ; 


Aft Select a row 

In the 74HC244, we first disable both units and 
proceed to turning on the one which is needed. This sequence 
prevents ghosting during the switching process. 

Do the main loop 

4 The outer part of the loop consists of logic that 
manages the addressing of the individual rows. Our program 
must flash the individual LED groups one after another using 
the building blocks described in the next step. 


Complete the loop 

l\# Writing out data is accomplished in a sequence of three 
commands. We select the row, configure the column and then 
write out the data bits that are to be displayed. A small pause 
is observed in order to give the LEDs some time to 'burn into’ 
the viewer's eyes. 



Above Digital LED matrices Like this one give you far more control over 
each individual ‘pixel’ in the display 


{ 

_where->writePinliOw(PIND2 ) ; 

} 


( _which& 8 ) 

{ 

_where->writePinHigh ( PIND3 ) ; 

> 


{ 

> 

{ 


where ->writePinLow ( PIND3 ) ; 
( which&16 ) 


} 


whe re -> writePinHigh ( FIND 4 ) ; 


{ 

} 

{ 

} 


where ->writePinLow(PIND4 ) ; 
( which&32 ) 


where->writePinHigh (PIND5 ) ; 


{ 

} 

{ 

} 


where->writePinLow(PlND5 ) ; 


(_which&64 ) 

where ->wr itePinHigh ( PIND6 ) ; 


{ 

} 

{ 

} 


where ->writePinLow( FINDS ) ; 
( which&128 ) 


where-'- wr itePinHigh ( PIND7 ) ; 


LED 

stripes 



Two versions of LED 
strips are offered, 
'Primitive’ ones are 
based on analogue 
technology, In it, an 
enti re stri p of d iodes 
has the colour set 
by the three input 
pins. Systems such 
as the mega-display 
shown in the left- 
hand image require 
the use of the 
digital version. They 
are based on the 
concept of the shift 
register. Your system 
inputs individual 
colour values which 
are then pushed on 
alongthe strip. 
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Full code listing 


Above This is the full schematic of the LED matrix that we're wo 
with here (you can also view it at its full size on FileSIlo) 


Energy control 

I I LEDs light up if current flows through them. SetData pulls 
the pins of the 74HC244 low to ensure that the energy supplied 
from the 74HC238 canf low through the diode. 

Avoid GPIO trouble 

I^d The Raspberry Pi Foundation has a tendency to change 
the layout of the expansion header regularly, a habit which 
professional manufacturers of process computers abhor. 
It’s recommended to handle the mapping between pins and 
functions via a set of defines. Our code is optimised for a 
Rev2 Raspberry Pi with a ‘short’ header - 40-pin variants will 
require readjustments making sure the physical pin numbers 
correspond to the logical GPIO numbers. 

Add example data 

UJ 1 Test the code by setting the datastore to a value of your 
choice. Setting 64 to all fields will disable one row in each part 
of the display. 

W Kick it off 

Check all connections between the planar and the 
single-board computer, and proceed to starting the compiled 
app. Don’t forget to use the sudo command - direct memory 
access is restricted to root in order to prevent apps from 
causing havoc in the physical memory. Users are accustomed 
to this, so requiring them to put a sudo in front of the 
command doesn’t cause concern. 

1C Notice a flicker 

!%#■' Sharp-eyed readers will notice an occasional flicker 
where one line appears brighter than the others. This is 
caused by the stalling of the program - if the kernel does 
other work, the switching routine can't run. We could solve 
this problem by usinga real-time Linux kernel. 


Step 13 


Step 09 


Step 10 


{ 


> 


where ->writePinLow( PIND 7 ) ; 


} 


{ 


mmapGpio rpiGpio; 

rpiGpio * setPinDir { PINAO t mmapGpio r : OUTPUT ) ; 
rpiGpio * setPinDir ( PINA1 f mmapGpio : OUTPUT ) ; 
rpiGpio * setPinDir ( PINA2 , mmapGpio : : OUTPUT ) ; 
rpiGpio * setPinDir ( PINA3 r mmapGpio : OUTPUT ) ; 

rpiGpio * setPinDir ( PINGS 0 , mmapGpio : : OUTPUT ) ; 
rpiGpio ,writePinHigh(PINCS0 ) ; 


rpiGpio 

rpiGpio 

rpiGpio 

rpiGpio 

rpiGpio 

rpiGpio 

rpiGpio 

rpiGpio 

rpiGpio 

rpiGpio 


setPinDir { PINGS 1 , mmapGpio 
writeFinHigh(PINCSl) ; 
setPinDir { PIND0 , mmapGpio : 
setPinDir ( PIND 1 r mmapGpio 
setPinDir ( PIND 2 f mmapGpio 
setPinDir ( PIND3 , mmapGpio : 
setPinDir { PIND4 1 mmapGpio : 
setPinDir ( PIND5 r mmapGpio ; 
setPinDir ( PIND6 f mmapGpio : 
setPinDir ( PIND 7 r mmapGpio : 


: ; OUTPUT ) ; 

: OUTPUT ) ; 

: OUTPUT ) ; 

: OUTPUT ) ; 

: OUTPUT ) ; 

: OUTPUT ) ; 

: OUTPUT ) ; 

: OUTPUT ) ; 

: OUTPUT ) ; 


dataStore [ ] [ 1 6 ] ; 


{ 

} 

> 


j=0; j<2; j++) 


k=0;k<16;k++) 


dataStore[ j] [k]=64; 


blockCounter=0 ; 
rowCounter- ; 

( 1 ) 

{ 

blockCounter H-; 

(blockCounter== 16 ) 

{ 

( rowCounter ==0 ) 

{ 

blockCounter-0 ; 
rowCounter =1 ; 

} 


{ 


blockCounter- ; 
rowCounter^ 0 ; 


} 


> 


saf elySetRow ( rowCounter , i rpiGpio ) ; 

setAddress ( blockCounter , & rpiGpio ) ; 

setData ( datastore [ rowCounter ] [ blockCounter ] , £ rpiGipio ) ; 

usleep( 50 ) ; 


} 


0 ; 


} 
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What you'll need 

Raspberry Pi 

■ Hover 

f Breadboard 

Male to female 
jumper cables 

■ Speaker or headphones 


People often ask what the best way is for them to 
get started with Raspberry Pi. Obviously this does 
depend on the individual user and what they want 
to achieve and get out of any project, but in a more 
general sense it’s often the hardware projects 
that win out for getting to grips with it. They teach 
a variety of skills (including programming, circuit 
building, soldering, hardware design and much 
more) and are also varied enough to both keep 
beginners interested and allow them to work out 
for themselves exactly what aspect they love 
best. Even a seasoned professional will get a 
serious kick out of a bit of physical computing and 


automation! This is one of the unique features of the 
Pi compared to traditional “black box” computers; 
you can break out of the usual boundaries and 
interface with everyday objects tike never before. 

One of the most important aspects of a hardware 
project is often the user input mechanism, and 
as technology is refined we see new and more 
intuitive ways to accomplish this task. Gesture 
and touch control is now present in a large 
number of consumer devices and even the biggest 
technophobes are starting to embrace the ease of 
this technology. It is time to bring your Raspberry Pi 
projects into the 21st century with Hover! 



ADD GESTURE CONTROL TO YOUR RASPBERRY PI 



I The physical pins you 
should be using on 
the Raspberry Pi are 
1,3, 5, 6, 16 and 18 

m Get the gear! 

The Hover add on board is available to purchase direct 
from Hover (http://www.hoverlabs.co/#shop) for $39 (£25), 
howeverthis will ship from Northern America and therefore if you 
are based in the UK or Europe it will Likely be quicker and cheaper 
to order from one of the other retailers listed via the above link. 
The added benefit of ordering from a retailer is that if you need 
any of the other items you can likely get those at the same time! 

Hover will work perfectly with any Raspberry Pi, including both 
the new plus versions and the older models - just make sure 
your system is fully up to date with: 

sudo apt-get update 
sudo apt-get upgrade 



Set up the hardware 

\ Make sure your Raspberry Pi is powered down and 
not connected to power before starting this step, to avoid any 
unnecessary damage to your Raspberry Pi. Pick up your Hover, 
breadboard and wires and connect the as shown in the Fritzing 
diagram. The physical pins you should be using on the Raspberry 
Pi are 1, 3, 5, 6, 16 and 18. Whilst a Model B Pi is shown, this will 
be the same connection on a Model A, B, A+ or B+ of any revision. 
Once completely set up like the image, reconnect the power cord 
and open an LXTerminal session. 


Update GPIO and I2C 

When making use of GPIO and I2C (or any other 
interfacing technique on the Raspberry Pi) it is always good 
practice to update to the very latest software versions possible. 
Newer versions typically have bug fixes and additional futures 
which can come in very handy. GPIO and the RPi.GPIO Python 
library are installed by default on Raspbian, but you may need to 
enable 120 if you haven’t already. This is a fairLy standard process 
and has been covered many times so we won’t go into it here. We 
would, however, highly recommend the brilliant I2C setup tutorial 
from Adafruit (https://learn.adafruit.com/adafruits-raspberry- 
pi-lesson-4-gpio-setup/configuring-i2c). 


Check the connection 

Hover connects to the Raspberry Pi through the 
I2C interface located on the main 26 or 40 pin GPIO bank 
(depending on which version of the Raspberry Pi you are 
using). There is a very easy way to check if your Raspberry Pi is 
correctly connected to Hover using the simple command line 
I2C tools. Issue the following command: 

sudo i2cdetect -y 1 

If you see 42 in the response then you are successfully 
connected to Hover 1 




Above You can tap 
the Hover or swipe 
infourdirections 
just above it 


Plenty of 
platforms 



The Hover board 
has intelligent on- 
board leveL shifting, 
meaning that it can 
be used with either 
3.3V or 5V logic 
Levels which means 
it can be used with 
pretty much any 
microcontroller your 
heart desires.There 
are connection 
examples and 
code snippets 
available for 
Arduino,Sparkcore 
and PCduinoon 
the Hover website 
(hoverlabs.com) and 
these can also be 
adapted to su it other 
devices fairLy easily. 


Ifyou decideto 
create your own 
example with 
another device then 
why not submit a pull 
request to the Hover 
GitHub (github.com/ 
jorvco91)if you are 
happy to share! 
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Above This MGC313Q 
chip works as the 3D 
tracking and gesture 
controller 


Why 

Python? 



Python is extremely 
useful for beginners 
duetoitseasy-to- 
understand syntax, 
fairly prose-like 
formation and the 
flexibility and ease 
of acquiring existing 
software libraries to 
help your projects. 

It is also the official 
programming 
language of the 
Raspberry Pi and is 
therefore very well 
supported within the 
community. That is 
not to say that H over 
will network with 
other programming 
Languages; simply 
that the creators of 
Hover have not yet 
released any code 
Libraries in other 
Languages. 



Using a Rev 1 Pi? 

in the code, we have passed an option “-y 1” which tells 
the operating system which I2C bus to look at (there are two on 
the BCM2835 processor on the Pi), The first revision Raspberry 
Pi (the one that initially launched in February 2012 with 256MB 
of RAM) made use of I2C bus 0, whereas all other versions of 
the Raspberry Pi since have used I2C bus 1. So the above code 
would change to: 

sudo i2cdetect -y 0 

And you should expect the same output (42) as in step 7. 
Additionally you will need to edit line 27 of the Hoverjibrary. 
py file, changing bus - smbus.SMBus(l) to bus - smbus. 
SMBus(O). A patch that automatically detects the Raspberry 
Pi version and makes this change for you has been submitted, 
but not yet accepted i nto the master branch so this may not be 
necessary in future versions. 


Download the sample code 

Now you have everything hooked up correctly and 
your Raspberry Pi is fully up to date, it is time to get the 
Hover Python library, which makes using the board from 
Python scripts extremely easy. You can get this using the 
following command: 


git clone https://github.conn/jonco91/hover_ 
raspberrypi.git 


This should download a folder called hover_raspberrypi to 
your /home/pi directory containing all of the files needed for 
this article. Alternatively you can download the zip file from 

https://github.com/jonco91/hover_raspberrypi/archive/ 

master.zip, 

p Run the example file 

\J 9 The current Hover library is simply a Python file 
with all of the necessary functions included within it, rather 
than an installable package (however, this may change in 
the future). In order to use the functions contained within 
the Hoverjibrary.py script discussed above, it is therefore 
necessary to make sure that the Hoverjibrary.py script is 
located in the same folder as any script you have written that 
makes use of any of the Hover functions. In a terminal session, 
navigate to the folder containing the Hover_example.py file 
and run it using: 

sudo python Hover_example.py 

The Hover board will initialise and you will then see a message 
“Hover is ready", meaning you are good to go. 



136 





ADD GESTURE CONTROL TO YOUR RASPBERRY PI 




Investigate the output 

Once you have completed step 7, if you touch the 
Hover board or make gestures above it you will begin to see 
output in the terminal which is a bunch of Os and Is and then 
a description of what it has seen - right swipe, north tap, 
etc. The way the Hover works is that it can sense any one of 
nine different actions and these are sent to the Raspberry Pi 
over I2C as an 8-bit binary value. The first three bits describe 
whether it was a touch or gesture event and the remaining five 
bits describe the specific type or direction of the event. The 
exact breakdown can be seen in the code listingto the right. 


Full code listing 

import time 

from Hover_library import Hover 

hover = Hover (address=0x42, ts=23 f reset=24) 

try: 

while True: 



Enable 3.5mm audio 

w Grab your speakers and plug them in to the 3.5mm jack 
plug on the Raspberry Pi. You will then need to route audio to 
the 3.5mm jack using the following command (you can skip this 
step f you are using an HDMI display, which has in-built audio): 

sudo amixer cset numid=3 1 



I # Make a drum machine 

l%r In the hover_raspberrypi folder is another folder called 
examples that contains code and sounds to turn Hover into a 
drum machine! Navigate to the hover_raspberrypi directory 
and then copy the Hover Jibrary.py file into the examples folder 
by using: 


cp Hover_library.py examples 


# Check if hover is ready to send gesture 

# or touch events 

if (hover . getStatus() == 0): 

# Read i2c data and print the type of 

# gesture or touch event 
message = hover .getEvent() 
type(message) 

if (message == “01000010”): 

# code for west touch goes here 
elif (message == “01010000”): 

# code for centre touch goes here 
elif (message == “01001000”): 

# code for east touch goes here 
elif (message == “01000001”): 

# code for south touch goes here 
elif (message == “01000100”): 

# code for north touch goes here 
elif (message “ “00100010”): 

# code for swipe right goes here 
elif (message == “00100100”): 

# code for swipe left goes here 
elif (message == “00110000”): 

# code for swipe down goes here 
elif (message == “00101000”): 

# code for swipe up goes here 

# Release the ts pin until Hover is 

# ready to send the next event 
hover .setRelease() 

time. sleep(0. 0008) #sleep for 1ms 


You can then move into the examples folder and run the Hover_ 
drum. py file using: 

cd examples 

sudo python Hover_drum.py 

Make some gestures and taps on and around Hover and you 
will have your own basic drum machine! 

Create your own responses 

The great thing about having a Python library available is 
that it is easy to integrate this device into any of your existing or 
future projects. The code shown is all you need to get started 
with Hover. You will see that on line 15 and onwards there are 
comments saying “code for... goes here”. Essentially all you need 
to do is insert the actions you want to occur on the particular 
event mentioned in the comment and you will be up and 
running... it really is that easy! 


except Keyboardlnterrupt: 
print “Exiting. . . ” 
hover, end() 

except: 

print “Something has gone wrong..." 
hover. end() 

Other project ideas 

Most of you are probably now wracking your brains for 
projects you could use Hover in, but let’s face it - pretty much 
any project that requires physical interaction would be made 
better with touch and gesture control. !f you think it is cool but 
are lacking inspiration, we recommend looking at the projects 
section of the Hover website at http://www.hoverlabs. 
co/projects, where there are projects by the creators and 
community alike. If you make something cool, be sure to send 
us the pictures! 




Where are the 
hover boards? 

Did you come 
here looking for 
information on how 
to build your space 
age transportation 
device? We cant 
help you with 
that, but we don't 
want to leave you 
disappointed! 
Hoverboardswere 
first popularised as 
a f ictionaL personal 
transportation 
method in the 1989 
film Back To The 
Future Part If and 
took the appearance 
of a Levitating 
skateboard with no 
wheels, 25 years 
later and it seems 
we might begetting 
close to turning this 
dream into a reaLity. 
Hendo Hoverboards 
have created a 
$10,000 hoverboard 
which uses a 
principle similar 
to that of maglev 
t rains to generate lift 
(kck.st/ZMd9AA), 
and more recently 
Ryan Craven has 
created a much 
cheaper alternative 
using four Leaf 
blowers and some 
other cheap parts 
(mrhoverboard. 
com/about). 
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Thumbsticks Push forward/ 

backward to switch between triangles 
and reverse sawtooth waves or push 
Le f t/r tg ht to af f e ct th e os el l lato rs 


CttOf You can play chords by 
manipulating threethumbsticks at 
once - how you move them affects 
the sound of the notes in the chord 


Joytone Note Map 


Hexagonal grid The Joytone 

uses a hexagonal layout for the notes 
like electronic musical instruments 
such as Rainboard orapps like Musix 


ISO IT All the chords and 

i 

scales yo u can play have the same 
geometric shape, no matter what key 
you're playingthem in 


Dtttwct In 

to N*4ghbonrtg Joyiticln 


Sh*p« f&r • mtfat chord Sh*p# for # mtoor chord 
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Above {ins Getting to know 

the musical distances between 
adjacent thumbsticks is the key 
to learning to play the Joytone 


There's a marathon Lab 
session behind this six-note 
demo unit that Sharpies and 
Glanzman presented at the CIS 
Senior Design Fair 



Components list 


Raspberry Pi Model B 
Cypress PSoC 4 
Arduino Micro 
fl 57 Xbox 360 thumbsticks 
57 NeoPixel Diffused 8mm 
Through-Hole LEDs (Adafruit) 

8 16-channel analogue multiplexers 
5 16mm Illuminated Pushbuttons 
(Adafruit) 

200mm SoftPot Membrane 
Potentiometer 


HOW I MADE: JOYTONE 



What inspired the Joytone? 

M David Sharpies The Joytone is an 
expressive isomorphic musical 
instrument which came out of my 
frustration trying to learn to play 
musical instruments. I was trying to 
teach myself piano and was wondering 
why there are white and black keys 
- it makes things so much harder. I 
learned a bit of music theory and came 
to realise that a major scale is just a 
well-defined musical structure; the gaps 
between the notes in a major scale are 
the same regardless of which major 
scale it is. But, because there are white 
and black keys on a piano, you can play 
a C major scale just by running up all 
the white notes. If you want to play a C# 
major scale you have to throw in a bunch 
of black keys. It’s hard to remember and 
you have to build up muscle memory. So 
one of the goals with this project is to 
build an instrument that doesn’t have 
that bias based on the keys - so it’s 
isomorphic; that’s what that means. 

And you’re using analoguethumbsticks? 

David Glanzmar They’re Xbox joysticks... 

That’s the second big goal of 
the project. When i was researching this, 
I noticed there were some instruments 
that had these isomorphic keyboards - 
a grid of hexagons - but the issue was 
that they were just buttons, they didn’t 
have the same richness and depth as an 
actual musical instrument. When you’re 
playing a guitar there are a million ways 
to affect the sound - how hard you’re 
pushing on the string, how hard you 
pluck it, where on the fret you’re holding 
it, if you bend the string or not - and you 
can get all these rich sonic qualities. So 
we wanted to make it isomorphic and 
we wanted to make it expressive. We 
used these thumbsticks because you get 
two channels of analogue control in this 
familiar little interface. One axis changes 
the waveform of the synthesised sound 
from a triangle wave (has a pure, bell-like 
quality) to a reverse sawtooth wave (has 
a buzzy, bright sound, like a trumpet). 
There are two oscillators creating each 



note and if you push the thumbstick to 
the left, those oscillators are exactly 
in tune, making a very soft sound. If 
you push it all the way to the right then 
they’re offset by a couple of hertz, which 
makes a wide, rich sound. Then the 
amount that you rotate the joystick gives 
the volume. So you have two and a half 
dimensions of control there, which adds 
some depth to the sound. 

What is the role of the Raspberry Pi? 

Sharp There’s a two-brain system 
going on - we have the Raspberry Pi and 
then we have the Cypress PSoC 4, The 
Cypress PSoC 4 does all the heavy lifting 
with the data reading. 

Glanzma It does all the measurements 
for the joysticks. It's got ADCs in it that 
convert analogue to digital, and then 
basically looks at each axis for each 
joystick in sequence, records it, and 
then waits for the Raspberry Pi to ask it 
for data values for each of the joysticks. 
Sharp There’s 57 thumbsticks and 
each one has two analogue channels, 
so that’s 114 analogue channels total. 
So what we did was we had eight 
16-channel multiplexers hooked up 
to the PSoC and then the PSoC sends 
a signal to all of them that says ‘give 
me channel one’. Then it reads the 
eight channels, and then it says ‘give 
me channel two’ and it reads the eight 
channel twos. After it does that for all 
16 channels it then has this full bank 
of current data. The Raspberry Pi 
periodically says ‘give me all your most 
recent data’, so the PSoC forwards the 
data to the Raspberry Pi, which then 
does a little bit of processing in Python 
and then sends commands to PureData, 
which is our synthesiser program. 

What's the Arduino component doing? 

Each thumbstick also has 
an RGB LED in its hexagonal cell, and 
our intention was to use these to show 
which nodes are in key or out of key. We 
also wanted to guide the user through a 
scale - or even a song, showing the next 
note that they’re supposed to play - but 


we ran into some technical difficulties. 
The ideal setup for this is that you 
daisy-chain all these lights in a big line 
and then hook them up to an Arduino 
Micro, which is really good at controlling 
these specific lights from Adafruit, and 
then it can just push all of this data down 
the line and you should just be able to 
put whatever colours you want on each 
light individually. But we had some 
problems with the signal and could only 
get about four lights to behave. 

Is it easy to learn to play the Joytone? 

Sharpie; The barrier to entry is much 
lower. It’s funny, when we first got it 
working, David was playing with it, 
wearing headphones, and he sort of 
stopped talking and was pushing a few 
of the joysticks, like ‘Wait, wait...’, and 
then he just played back Bach. So the key 
to learning it is just learning a little, tiny 
bit about the structures in music theory. 
There’s a shape you can hold your fingers 
in that will play a major chord; once you 
learn that shape, that’s it - that’s how all 
of the Joytone’s major chords are played. 
Glanzma When it comes to learning 
the Joytone, you have to attack musical 
instruction differently than you would 
with another instrument. When you 
learn something like the piano, you 
learn that this is D major, this is F# 
minor - you learn different things 
based on the note, the actual class. 
But with the Joytone, the pitch class 
is totally irrelevant because we hear 
everything in relevant terms, and you 
play everything in relative terms. So to 
learn the instrument, you don’t even 
have to discuss pitch classes - you 
just talk about relative distances. So 
major thirds or minor thirds, fifths, 
fourths - it’s distances between notes 
instead of the actual note values. 
I think if you phrase musical instruction 
in those terms, in terms that we 
experience music in rather than the 
terms we normally go through to create 
music, it becomes a much more natural 
interface because it’s built on that type of 
instruction, making it simple to learn. 



David 

Sharpies 

is an interaction 
designer and 
graduated from 
the University of 
Pennsylvania's 
Digital Media Design 
programme 



David 

Glanzman 

isasophomore 
in Computer 
Engi neeringat 
the University of 
Pennsylvania. 

David has worked 
on microprocessor 
design, audio 
electronics, medical 
devices and more 

Like it? 

Interested in 
learning more 
about isomorphic 
instruments? 

Check out David 
Sharpies’ senior 
design blog: 
davesharpLes/btog 

Further 

reading 

Here’s the final 
demo video of the 
Joytone, comprising 
David Glanzman’s 
virtuoso Bach 
performance: 
bit.ly/lvfXnlw 
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Even with a platform as cheap, simple and powerful as the 
Raspberry Pi, taking your first foray into the world of physical 
computing and hardware projects can often be a fairly 
daunting experience. There are a number of extra factors to 
consider, and the margin for error can be quite a bit slimmer, 

On the plus side, however, physical computing is perhaps the 
most rewarding way to experiment with computers and coding, 
as it allows you to manipulate tangible items in the physical world 
with the powerof code. You’Ll learn plenty of essential skills along 
the way, and the thrilling reward of seeing your code manifested 
in a physical action simply can’t be beaten. 

One of the best ways to start making use of those GPIO pins 
and get really creative with your Pi Later is a simple LEO project, 
as it will allow you to see the main GPIO commands in action. 
Now getyour Raspberry Pi, LEDs and jumper cables at the ready 
and let’s get started ! 


Get the parts 

The parts for required for this tutorial should all be 
available from any reputable electronics dealer such as Maplin, 
CPC or one of the many independent Raspberry Pi retailers. The 
breadboard, LEDs, cables and resistors should cost you around 
£5 to £10 maximum. 

Update your Pi 

Before undertaking any project, regardless of whether 
it is hardware or software based, you should always update 
your Raspberry Pi to ensure you have the most stable software 
versions and Latest functionality. This is especially important 
when experimenting with GPIO. You can do this using the 
following commands: 
sudo apt-get update 
sudo apt-get upgrade 







SIMULATE TRAFFIC LIGHTS USING YOUR BREADBOARD 
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Prepare the hardware 

To begin, build and test a simple circuit to ensure 
everything is working correctly. Grab the breadboard, two 
jumper wires, the red LED, one 330 Ohm resistor and your 
Raspberry Pi, and connect everything together as shown in the 
above image. Ensure your Raspberry Pi is powered off when 
connecting things to the GPIOto avoid damage. 


M Add some code 

The code below is a simple snippet to test that the 
connection is correct and that the LED is working. Create 
a blank Python script by typing sudo nano test.py at the 
command line and then writing in the code below. Save and exit 
the script by using Ctrl-X and then pressingYand Enter. You can 
then execute the script by typing sudo python test.py at the 
command line. 


import RPi.GPIO as GPIO 
import time 



Add more code 

In order to simulate a reaL block of traffic lights, we 
need to run through a sequence of colours. The code below 
achieves this, and the version we’ve uploaded to FileSilo.co.uk is 
commented throughout so you can understand what it is doing. 
As in step4, you will need to add this to a Python script to execute 
it, calling it ‘trafficlight.py' this time instead of ‘test.py’ as before. 


import RPi.GPIO as GPIO 
import time 


GPIO. setmode(GPIO. BCM) 
Leds = [14,15,18] 


for Led in Leds: 

GPIO.setup(Led, GPIO.OUT) 
GPIO.output(Led, False) 


GPIO. setmode (GPIO. BCM) 

GPIO. setup ( 14 , GPIO.OUT) 

GPIO.output®, True) 
time.sleep(10) 

GPIO. output (14, False) 

GPIO.cleanupC) 
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Connect more LEDs 

For a simulation of an actual traffic lights rig, we 
obviously need to add a green and yellow LED into the 
mix. Grab the LEDs and two more resistors, then connect 
everything together like in the image above, again ensuring 
the Pi is powered off first. 


try: 


while True : 


GPIO. output (Leds B ] , 

True) 

time.sleep(10) 


GPIO. output(Leds [1] , 

True) 

time, sleep® 


GPIO. output (Leds [6] , 

False) 

GPIO. output(Leds [1] , 

False) 

GPIO. output (Leds [2] , 

True) 

time, sleep (18) 


GPIO. output(Leds [1] , 

True) 

GPIO.output(LedsC ], 

False) 

time.sleep( ) 


GPIO.output(Leds[l] , 

False) 


except Keyboard] 

GPIO.cleanupO 


Where to go next? 

This was just a very simple introduction to 
experimenting with the GPIO on the Raspberry Pi. It shows how 
easy it is to manipulate things in the physical world with code 
and this is often the best way to learn. Check out the Raspberry 
Pi Foundation resources section for more great ideas - 
raspberrypi.org/resources. 


Ladder 

game 



Once you Ye up to 
speed with the 
basics of controlling 
LEDs with your Pi, 
why n ot make a 
game that develops 
that knowledge 
further? One project 
that is particularly 
good forthisisthe 
ladder game, as 
it involves finely 
controllingthe 
timings and more 
complex Loopsfor 
user interaction. 
Check out projects* 
drogonmet/ 
raspberry-pi/gpio- 
examples/ladder- 
game for a great 
guide to this. 




The Raspberry Pi is a fantastic project board. Since we love 
a challenge, we set out looking for something to really take 
advantage of its capabilities in the most spectacular way 
possible, something that would really push the limits of our 
hacking and coding skills. We chose a quadcopter. 

Kits are available as ready-to-f ly (RTF) if you just want the 
joy of flight, but where’s the challenge in that? We started 
with an almost- read y-to -fly (ARF) kit - the DJI Flame 
Wheel F450 - all the hardware, but none of the control 
electronics or software. Many enthusiasts have created 
DIY quadcopters using Arduino microcontrollers, so we 


knew a DIY build was possible, but very few, if any, have 
successfully used the Raspberry Pi. 

This article uses the Python code on the disc as a guide 
through what's needed to build a quadcopter, metaphorically 
bolting it together so that by the end, you don’t just understand 
the code but also the interaction with the real-world to enable 
you to build your own quadcopter with confidence. 

As you read the article, you can follow the corresponding 
code by searching for an equivalent tag comment; for example, 
to find the code related to the *# Angles’ section of the article, 
simply search the code for ‘# Angles’. 
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Propulsion Here we're seeing 
the force from the propellers 


Vectors Propeller force reLatfveto 
Earth's axis (horizontal / vertical) 


a 


qx 


a 


q □ 



a s = gravitational acceleration 


a q = quadcopter acceleration 

a 


lqx | = a q (reorientated to Earth’s axes) 


a qy 

□ = angle of tilt derived from 
accel + gyro 


Gravity This term denotes the 
force of gravity 


a 


qz 


a 



Angle This is the angle of tilt as 
defined by the quads sensors 



a cx = tan □ 


a 


qy 


for horizontal flight 

a qz — § — ^ 

horizontal accel a qx = 


+ a 


# Interpreter 

The command interpreter converts a series of commands 
either from a radio control or programmed into the code itself. 
The commands combine the direction and speed compared to 
the horizon that the user want the quadcopter to follow. The 
code converts these commands into a series of targets 
for vertical speed, horizontal speed and yaw speed - any 
command from a pair of joysticks can be broken down into a set 
of these targets. 

# Inputs 

The inputs to the quadcopter come from a series of electronic 
sensors providing information about its movement in the 
air. The mam two are an accelerometer which measures 
acceleration force (including gravity) in the three axes of the 
quadcopter, and a gyroscope which measures the angular 
speed with which the quadcopter is pitching (nose/tail up 
and down), rolling (left/right side up and down), and yawing 
(spinning clockwise and anticlockwise around the central axis 
of the quadcopter itself). 

# Axes 

The accelerometer is relative to the orientation of quadcopter 
axes, but the command targets are relative to the Earth's 
axes - the horizon and gravity. To convert the sensor output 
between the quadcopter axes and the Earth axes needs a little 


Understanding 

quadcopters... 

Although this article focuses on software, a very basic 
background in the hardware from the kit is necessary to 
provide context. 

A quadcopter has four propellers (hence the name) 
pointing upwards to the sky, each attached to its 
own brushless DC motor at one of the four corners of 
(usually) a square frame. Two motors spin clockwise, two 
anticlockwise, to minimise angular momentum of the 
quadcopter in flight. 

Each motor is driven independently by an electronic 
speed controller (ESC). The motors themselves have three 
sets of coils (phases), and the ESCs convert a pulse-width- 
modulation (PWM) control signal from software/hardware 
to the three phase high-current output to drive the motors 
at a speed determined by the control signal. 

The power for the ESCs and everything else on the 
system comes from a Lithium Polymer battery (LiPo) rated 
at 12V, 3300mA with peak surge current of 100A - herein 
lies the power! 


Above How sensors 
in the quadcopter 
point of view are 
converted to the 
Earth {horizontal/ 
vertical) viewpoint 
to provide 
horizontal motion 



ELECTRONICS 
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The angle PID takes the desired tilt 
angle from the horizontal speed PID 
and feedback from the gyro and the 
accelerometer combined to produce 
the tilt angle feedback* This results in 
the required angular speed 


The angular speed PID takesthe 
required angle PID out, with feedback 
from the gyro to apply power to the 
motors. This produces the required tilt 
and horizontal movement 


I 


Pitch/Roll 
Angle 



Radio 

Control 


"PID — 
Target 




The PID outputs are applied 
appropriately to each propeller ESC 
to effect the change defined by the 
proceeding commands 


The yaw PIDs are used to ensure the 
quadcopter doesn’t rotate its Z-axis 
in flight 




Complementary 
Filter 





Commands 



Yaw Angle 


Autonomous 

Control 


PID 

Target 


Commands 


Vertical 

Speed 



PID 

Target 


The horizontal speed PID takes 
movement commands and feedback 
from integrated gyro sensors to define 
the desired tilt and angle to achieve 
the required speed 




The vertical speed PID directly 
controls the desired rate of climb 
or descent with feedback from 
integrating Z-axis accelerometer data 


Commands from the radio-control 
or programmed route are processed 
and converted into a set of desired 
movements in the X, Y and Z axes 


Above PIDs connecting commands 
and sensor feedback to produce an 
outputdrivingthe propeller blade 
(E)Lectronic (S)peed (Controllers 


trigonometry and knowledge of the tilt angles in pitch and roll 
axes of the quadcopter with respect to the Earth* 

# Angles 

Both the accelerometer and gyro can provide this angle 
information, but both have flaws. 

The accelerometer output can be used to calculate the angle 
by using the Euler algorithm. However, the accelerometer output 
is plagued by noise from the motors/propellers, meaning a single 
reading can be hugely inaccurate; on the plus side, the average 
reading remains accurate overtime. 

In contrast, the gyro output does not suffer from the noise, 
but since it is the angular speed being measured, it needs to be 
integrated overtime to find the absolute angle of the quadcopter 
in comparison to the horizon. Rounding errors in the integration 
lead to ever increasing errors overtime, ultimately curtailing the 
maximum length of a flight. 

# Filter 

Although independently they are both flawed, they can be 
merged mathematically such that each compensates for the 
flaws in the other, resulting in a noise-free, long-term accurate 


reading. There are many versions of these mathematical noise/ 
drift filters. The best common one is by Kalman; the one we've 
chosen is slightly less accurate, but easier to understand and 
therefore to code: the complementary filter. 

Now with an accurate angle in hand, it’s possible to convert 
accelerometer sensor data to inputs relative to the Earth’s axes 
and work out how fast the quadcopter is moving up, down, left, 
right and forwards and backwards compared to the targets that 
have been set. 

# PIDs 

So we now have a target for what we want the quadcopter to 
do, and an input for what it’s doing, and some motors to close 
the gap between the two; all we need now is a way to join these 
together. A direct mathematical algorithm is nigh on impossible 
- accurate weight of the quadcopter, power per rotation of each 
blade, weight imbalance etc would need to be incorporated 
into the equation. And yet none of these factors is stable: 
during flights (and crashes!), blades get damaged, batteries 
move in the frame, grass/m ud/moistu re changes the weight 
of the 'copter, humidity and altitude would need to accounted 
for. Hopefully it’s clearthis approach simply won’tf ly. 
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Both the accelerometer and gyro can provide 
the angle information, but both have flaws 


Instead, an estimation method is used with feedback 
from the sensors to fine-tune that estimate, Because the 
estimation/feedback code loop spins at over 100 times 
a second, this approach can react to ‘errors’ very quickly 
indeed, and yet it knows nothing about all the factors which 
it is compensating for - that's all handled blindly by the 
feedback; this is the PID algorithm. 

It takes the target, subtracts the feedback input, 
resulting in the error. The error is then processed via 
a Proportional, Integral and a Differential algorithm to produce 
the output. 

# Blender 

The outputs are applied to each ESC in turn: the vertical speed 
output is applied equally to all blades; the pitch rate output is 
split 50/50 subtracting from the front blades and adding to the 
back, producing the pitch. Roll is handled similarly. Yaw too is 
handled in a similar way, but applied to diagonal blades which 
spin in the same direction. 

These ESC-specific outputs are then converted to a PWM 
signal to feed to the hardware ESCs with the updated propeller/ 
motor speeds. 


Code and reality 

In this code, there are nine PIDs in total. In the horizontal plane, 
for both the X and Y axes, the horizontal speed PID converts the 
user-defined desired speed to required horizontal acceleration/ 
angle of tilt; the angles PID then converts this desired tilt angle to 
desired tilt rate which the rotation speed PID converts to changes 
in motors speeds fed to the front/back or left/right motors for 
pitch/roll respectively 

In the vertical direction, a single PID converts the desired rate 
of ascent/descent to the acceleration output applied to each 
plate equally. 

Finally, prevention of yaw (like a spinning top) uses two PIDs 
-- one to set the desired angle of yaw, set to 0, and one to set the 
yaw rotation speed. The output of these is fed to the diagonally 
opposing motors which spin in the same direction. 

The most critical of the nine are pitch/roll/yaw stability. 
These ensure that whatever other requirements enforced by 
other PIDs and external factors, the quadeopter is stable in 
achieving those other targets; without this stability, the rest 
of the PIDs cannot work. Pitch is controlled by relative speed 
differences between the front and back propellers; roll by left 
and right differences, and yaw by clockwise/anticlockwise 


r ^ 
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Aquadcopterina 
headwind wiLL drift 
backwards due to the 


force applied by the wind 


differences from the corresponding PIDs' outputs. The net 
outputs of all three PIDs are then applied to the appropriate 
combination of motors’ PWM channels to set the individual 
pulse widths. 

With stability assured, some level of take-off, hover and 
landing can be achieved using the vertical speed PID. Placing 
the quadcopter on a horizontal surface, set the target to 0.5 m/s 
and off she zooms into the air, while the stability PID ensures that 
the horizontal attitude on take-off is maintained throughout the 
short flight, hover and landing. 

Up to this stage, the PIDs are independent. But what about 
for horizontal movement target, and suppression of drifting in 
the wind? 

Taking the drift suppression first, a quadcopter in a headwind 
will drift backwards due to the force applied by the wind. To 
compensate, it must tilt nose down at some angle so that some 
of the propellers' thrust is applied horizontally to counteract the 
wind, in doing so, some ofthe power keeping the ’copter hovering 
at a fixed height is now battling the wind; unless the overall 
power is increased, the ’copter will start descending. 


Horizontal movement is more complex still. The target 
is to move forwards at say 1 metre per second. Initially the 
requirement is similar to the headwind compensation - nose 
down plus increased power will apply a forward force leading 
to forward acceleration. But once that horizontal speed 
is attained, the quadcopter needs to level off to stop the 
acceleration, but at the same time, friction in the air will slow 
the movement. So there’s a dynamic tiltingfore/aft to maintain 
this stable forward velocity. 

Both wind-drift suppression and controlled horizontal 
movement use nested PIDs; the X and Y axes horizontal speed 
PIDs’ outputs are used as the pitch and roll angle PIDs targets; 
their output feeds the pitch and roll rate PIDs to ensure stability 
while meeting those angular targets. The sensor feedback 
ensures that as the desired horizontal speed is approached, the 
horizontal speed PID errors shrink, reducing the targets for the 
angular pitch PID, thus bringing the quadcopters nose back up to 
horizontal again. 

Hopefully it now becomes clearer why accurate angle 
tracking is critical: in the nose-down, headwind example, the 
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Front 




Propellers The propellers are set 

diagonaLLytothe x, y axes, and rotate as shown 
to reduce yaw (rotation about the z-axis) 


V 


Ork SI Itior The overall orientation of the 


quadcopter depictingfront, back, left and right 
in relation to the sensor and p rope Her Layouts 


■ 


A 


sensors The quadcopters’ 

sensors report data according to 
these x, y and z axes 


I 
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input to the vertical speed PID from the sensors is reduced by 
the cosine of the measured angle of ’copter tilt with respect to 
the horizon. 

Similarly, X and Y axis speed PID sensor inputs need 
compensating by pitch and roll angles when comparing target 
speeds against accelerometer readings. 

Experimentation and tuning 

While the code accurately reflects everything we’ve described 
here, there’s one critical set of steps which can only be 
found through live testing; these are the PID gains. For each 
PID running, there is an independent Proportional, Integral 
and Differential gain that can only be found with estimation/ 
experimentation. The results for every quadcopter will be 
different. Luckily there is a relatively safe way to proceed. 

First, find the PWM take-off speed: this is done by sitting 
your quadcopter on the ground and slowly increasing the 
PWM value until she starts looking light-footed - for your 
expert, this was about the 1590us pulse width (or lOOOus 
+ 590us, as shown in the code). 

Next, sorting out the stability PIDs - assuming your 
quadcopter is square and its balance is roughly central, 
then the result of pitch tuning also applies to yaw 
tuning. For pitch tuning, disable two diagonally opposed 
motors and rest these on a surface - the quadcopter sits 


horizontal in between. Power up the dangling motors’ 
PWM to just under take-off speed (1550us pulse width in 
our expert’s case). Does the quad rock manically, wobble 
in some pretence of control, self-right when nudged, or do 
nothing? Tweak the P gain accordingly. Once P gain is good, 
add a touch of I gain - this will ensure return to 0 as well as 
stability. D gain is optional, but adds firmness and crisp 
response. Tapping a D-gain stable quad is like knocking on 
a table - it doesn’t move. 

Vertical speed PID can be guesstimated. 1590us is taking 
off; desired take-off speed is 0.5m/s so a P gain of 100 is 
okay. No I or D gain needed. 

With that a real take-off, hover and landing are safe, which 
is good as these are the only way to tune the directional PIDs. 
Just be cautious here - excessive gains lead to quadcopters 
slamming into walls or performing somersaults in mid-air 
before powering themselves into the ground. Best executed 
outside in a large open field/garden/park where the ground is 
soft after overnight raini 

There isn’t a shortcut to this, so just accept there will be 
crashes and damage and enjoy the carnage as best you can! 

Assuming all the above has gone to plan, then you have a 
quadcopter that takes off, hovers and lands even in breezy 
conditions. Next step is to add a remote control, but that’s for 
another article... 


Above The 

orientation of 
the quadcopter 
compared to the 
direction of travel, 
the rotation of the 
pro pellers and 
the axes used in 
the code 
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Play an AR Light 


gun game 


Turn your Pi into 


There are now over five million Raspberry Pi models out in 
the wild, and some of the things that you, the Raspberry 
Pi community, have made with them truly are wild. From 
elegantly crafted scripts that chain together a series of web 
services to homebrew Rube Goldberg machines, they are as 
creative as they are diverse. And through the crowd of new 
projects bubbling up online every day, if there’s one word that’s 
guaranteed to get everyone’s attention then it's the word ‘hack’, 
But what exactly is a hack? Well, for the purposes of this 
feature, we decided that a hack has to have some sort of 
hardware base. It’s the kind of project where you take one 
device and, with a little Raspberry Pi magic, transform it into 
something wholly new and original. These are the projects 


that get us excited and make us want to learn more about 
electronics, engineering and programming. 

Over the next few pages we’re going to introduce you to 
some of the greatest Raspberry Pi hacks we’ve discovered. 
Projects where vintage hardware has been torn apart and 
the components repurposed into something amazing, or 
where the hardware has been puzzled over, fiddled with, 
and brought back to life after years spent in a garage. These 
hacks inspire us, with each maker striking the right balance 
between passion, skill and virtuosity, and we hope they 
inspire you too. Read on as we hear how you can launch a 
satellite from a bedroom spaceship, transform an analogue 
camera into a digital one, make a classic Apple Pi and more. 
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Camera Pi 


Power up a regular point-and-shoot DSLR camera 


Maker Prof ile 
Dave Hunt 

Photographer 
and maker 

David has been 
making projects for 
the Raspberry Pi 
since the earLy days. 

Find out more: 

davidhunt.ie 


Dave Hunt is well known to Raspberry Pi 
fans, and here he’s back with his Camera Pi. 

“I needed to transmit photos to an iPad 
as they were taken,” explains Dave, “but the 
commercial solutions were £500. 1 had a broken 
battery grip big enough to fit my Raspberry Pi 
and a battery, so it went from there. 

“The battery grip holds two batteries. Once 
I’d stripped out the battery compartment, I set 
about filing down all the mounting holes inside 
the grip so I could get the Raspberry Pi inside. 


“The next task was to fit 
a camera battery and DC-DC 
converter inside. I was able to use part of the 
removed internals of the grip, and before long 
I had a slot to insert a camera battery into. It’s 
capable of poweringthe Pi forabout four hours. 

“Making it wireless was a case of plugging 
in a USB Wi-Fi adapter. A few lines of Perl later 
and I was able to poll the camera with gphoto2, 
pull the new files off and send them via FTP to 
ShutterSnitch on my iPad." 


Above 


Read up on the full build 
process and check out Dave’s 
video at bit.ly/lBxEMbC 
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Pi Telephone 

Revive a ringing phone with C# circuit 
wizardry and voltage manipulation 


Maker Profile 

Stuart 

Johnson 

Managing 

director 

Stuart runs 
Logic Ethos, an 
IT company in 
Southampton 
providing network 
services and cloud 
computinghelp 
to developers. 

Find out more: 

logicethos.com 


Stuart Johnson is bringing a classic GPO 746 handset 
back to life, and while the project isn’t yet complete, 
he has finished the lion’s share of it. 

“I took out the main circuit board inside the phone 
and squeezed the Raspberry Pi in there,” says Stuart. 
“I was then faced with two challenges - the biggest 
one was getting the bell to ring. I found a solution by 
raising the voltage to 19 volts and dropping it down to 
5 for the Ras Pi using a very small DC-DC converter 
(the OKI-78SR), with the rest then being used for the 
bell. I was surprised by how well it worked. 

“The bell is using one of the S/0 ports, and there’s an 
available C# library (raspberry-sharp-io) which lets 
you monitor and control those ports. So I linked one of 

the I/Os to the pulse dial and connected 
another to a relay using 
transistors. Then with the 
software I put in a timer to 
measure the pulse clicks. I 
managed to write some 
code to time those 
pulse clicks and 
determine the 
number 
dialled.” 



Car Computer 

Ours was good, but Derek Knaggs really 
has built the real deal 

Remember the car computer that we made 
earlier? Well Derek Knagg already beat us to it, and 
he’s embedded the display in his dashboard and 
extended the setup to include screens for the rear 
passenger seats too. 

“I removed the DVD player, which was a standard 
Ford head unit,” explains Derek, “and then 
purchased a head unit from Xtrons. it’s designed 
for the Ford Focus so it was a straight swap. The 
Xtrons radio has an S-Video input and that goes into 
the radio, so the Raspberry Pi displays as Auxiliary 
Input. There’s two Auxiliary Outputs on the radio, 
so the Raspberry Pi sends a video to the main radio 
which then sends it back out to the screens in the 

passenger seats. What I’ve done 
is put in a device - like a VGA 
adaptor: it takes one input and 
puts seven out - that gives me 
the ability to have the Raspberry 
Pi running to the back screens 
on their own, so the radio can 
then control itself. I can have 
my kids watching movies at 
the back with the Raspberry Pi 
using an audio splitter (they've 
got headphones on), and we can 
be at the front using the normal 
Above In this setup, the Pi is one of radio controls, like the satnav for 

the inputs for the Xtrons head unit example. So that works well.” 



Maker Profile 

Derek Knaggs 

Managing 

director 

Derek Knaggs runs 
FiameLi[yiT ? anlT 
supply and support 
company, and is 
studying Computing 
at the University 
of Worcester. 

Find out more: 

fLameLily.co.uk 
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NES compared to an original 


RetroNES 

Now you're playing with power. Raspberry Pi power to 
be exact, situated inside an old game console 

Chris Crowder 

Programmer and database administrator 

+ B + B + S + B + S + S + fl + P + Pi|>B‘IBi|#‘!"|iB + B-t‘B-|ifl + S + B + B + H + B4-Ri|-BB-B4PBPB>#B-tB-»iB-BS + B + fl# + 

Working in the car industry, Chris develops 
manufacturing systems for production floor 
systems using .Net and SQL. In h is down time, he 
likes to play videogames and tabletop games, but 
was previously li mited to his PC for the former. 

Find QUt more: imgurxom/a/KPi2n?gaUery 




It was a little intimidating at first as 
I wanted to make sure that this project 
looked and felt like an NES 



“It all started when my wife asked me what I 
wanted for Christmas”, said Chris over email. I 

had absolutely no idea but I had been wanting to 
mess around with a Raspberry Pi since it came 
out, so she got me a starter kit. 

“While waiting for Christmas I started 
narrowing down ideas and found the RetroPi 
project. I thought that I would just install 
that, load some ROMs and call it good, then 
I remembered that I had some old NES and 
SNES controllers in storage. I went to get them 
and found my old childhood NES console along 
with the controllers. Once I got the NES back in 
the house and started looking at it, I found that 
almost all of the internals were damaged due 
to insects and moisture. All of the connectors 
were corroded and some of the boards had 



Above Everything is packed inside the original 
case, without needing to open it up to use it 


traces that were peeling. That is when I 
decided that I would use the Raspberry Pi to 
‘resurrect’ the NES.’ ! 

Chris completely gutted the case and 
replaced the insides with a Raspberry Pi, 
hooking up I/O ports to the original connectors 
for the controllers and the AV cables and such. 
What’s it like taking on a project with one of the 
most revered consoles in videogame history? 

“It was a little intimidating at first as I wanted 
to make sure that this project looked and felt 
like an NES but with more flexibility. The biggest 
issue I ran into was that I wanted it to be able 
to work like an NES, meaning that if someone 
wants to play a game that they just turn it on, 
select a game and then they are playing. When 
they are finished all they have to do is press the 
power button to turn the console off. We can’t 
do that easily with a Raspberry Pi since there is 
no ATX-style power switch. I was able to solve 
this issue with a Mausberry Circuit and a Python 
script. When the power button is pressed it 
communicates with the Pi via a GPIO connection 
and it runs the shutdown command. Once the Pi 
is shut down, the circuit cuts the power to the Pi.” 

The final product works great, with Chris 
reporting he can play on Atari, Sega and 
Nintendo games just fine. He’s now looking to 
upgrade it with a Raspberry Pi 2 and increase 
the number of games he can play. 


Refitting a NES 

Do you fancy taking on the challenge of 
bringing your old console back to gloriously 
pixelated life? Thought so. In that case, 
you’ll be needingthis - here’s a list of the 
equipment that Chris used to repair and 
revive his childhood NES console: 

• A broken NES console - please don’t do 
this to a working console 

• Replacement NES Door 

• Canakit Starter B+ - soon to be replaced 
with a Raspberry Pi 2 

• Panel Mount Ethernet Cable 

• PanelMount HDMI Cable 

• Panel Mount USB Cable 

• USBA Male Connectors lOpk 

• SNES USB Controllers 

• Anker 13000 mAh 3 watt Battery - this is 
for when there is no power outlet nearby 
or you want to be portable 

• Mausberry Circuit - shutdown circuit 
that uses your own switch, USB 

• LEGO -to hold the Mausberry Circuit 

• Gorilla Glue 

• Blue 3-volt LED - the original NES LED 
was 12 volts, plus all of the other items in 
Chris’ entertainment console are blue 
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Outside of 
playtime, this is 
just an ordinary 
homework desk. 

Almost 





Mission 
Control Desk 

Astronaut training begins 
early in Jeff Highsmith's 
home, with his sons running 
launches from their home- 
made Mission Control 


The Mission Control 
desk groups the 
various functions 
into ‘station’ panels 


Jeff Highsmith 

Tin kere r ext rao rd inai re 


* -i * tt- i- a + 4 * a - 
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l + MItlHHIll 1 ! 
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Jeff Highsmith Loves to make new and novel, 
things. The medium isn’t important, and he 
enjoys scrounging for materials and making 
do with what’s at hand. 

Find out more: jeffhighsmith.com 



The panels 

components. Jeff ordered the switt 
then designed the panel layout and labels 
on his computer, printing them on inkjet 
transparency - dear acetate - and then 
gluingthose onto somef ibreboard that 
he had spray-painted a metallic grey. He 
estimates that the whole budget was 



Above These reflect the real stages of a NASA 
mission and play authentic recorded sounds 


Jeff Highsmith is probably the best Dad in 
the world. Not content to just build his son a 
desk for his room, he modified it so that space 
adventures can start with the push of a button. 

“My eldest son was starting kindergarten and 
he needed a desk to do his homework on," Jeff 
tells us, “and since I like to build stuff I thought 
I would make him a desk rather than buy one, 
and i was thinking, ‘What would make a really 
awesome desk?’ Well, having lots of buttons and 
switches like a mission control desk! Carpentry- 
wise it was pretty simple to build. 

“The Raspberry Pi is up in the front-centre 
behind a piece of flexiglass, next to the Arduino 
that takes care of reading the inputs. The Pi 
handles all the sounds and the logic - the 
gameplay aspect. That was my first Python 
experience and it was pretty good. 

“The desk has got several modular panels 
and each has a different function. So in the 
real mission control at NASA there’s a desk 
that controls the retro stage, and for this desk I 
made a retro booster panel and put a bunch of 
rocket noises on it. There’s a capcom (capsule 
communicator) panel, so you put on a little 


headset and you can talk to the astronaut that is 
in the spaceship in the other room. 

“There are a couple of panels that have 
numerical displays: one reads out some attitude 
numbers, like x, y and z in space, and there’s 
one that monitors the astronauts’ vital signs 
(supposedly). There’s one that does mechanical 
spaceship noises, like pumps, heating elements, 
buzzing noises, fans etc. I wanted it to be like 
you’re turning things on and off, not just pushing 
a button that plays a sound - that’s why I have 
the toggle switches as well as push buttons. 
There’s a spot for the iPad in the middle too - you 
can watch videos of rocket launches. 

“There are homages to actual NASA 
emergencies, like the stirring of the oxygen 
tanks that led to the Apollo 13 explosion, i have 
a switch that makes it sound like it’s stirring 
the tanks, then it makes an explosion sound 
and plays the audio from the astronauts 
talking: ‘Houston - we have a problem 1 . There’s 
a sequence panel too that has the different 
mission stages on it and each of those plays a 
real NASA soundbite, all the way from the launch 
to the landing on the Moon to the splashdown.” 
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Spaceship Bedroom 

After successfully accomplishing his desk 
mission, Jeff Highsmith set his sights higher 


Mission control was but one small 
step. Next was the mission itself, 
as Jeff explains: “So my boys would 
hit the buttons on the desk and go 
through all those mission stages and 
run around with their toy rockets, but 
having the actual spaceship, I thought, 
would be cool. The spaceship has 
some panels similar to the desk, but 
if also has a small screen in there that 
goes to a video camera in the cargo 
bay. There’s a motorised hatch on the 
side that you can open up by flicking 
a switch, and then the camera shows 
you a cargo bay with a robot arm 
inside it. You can’t see the cargo bay 
when you’re inside because you’re 
laying on your back, but looking at the 
screen you can see it and the controls 
are in front of you. It really feels quite 
fun - I’ve got a little toy Hubble space 
telescope in there and 1 hung a piece of 
fishing line from the ceiling with a little 
bit of metal on it, and then I’ve got a 
magnet in the space telescope. So you 


take the telescope from the cargo bay 
with the arm, move it over and snap 
it onto the string that hangs from the 
ceiling - we call that orbit. Once it’s in 
orbit you can pull the arm back in the 
cargo bay, close the hatch and your 
mission is complete, you can return to 
Earth. And then there’s the inevitable 
mission to goand fix the Hubble. .. 

Jeff’s going to upgrade this 
awesome setup further. “Eventually,” 
he says, “I’ve got some ceiling satellites 
planned, so I’ll have them orbiting a 
track in one of the bedrooms and the 
iPad can monitor the different sensors 
on the satellites. The track will be a 
thin metal rod under the ceiling in an 
ellipse, and then each satellite will 
have a tiny wheel extending from the 
top of it, which has a very small gear 
motor on it, so it’ll hang from the track 
on that wheel. The idea is that the kids 
can build satellites out of Lego, put 
them in the cargo bay, then winch them 
up into orbit.” 



spaceship 
would be cool 


Automatic Roller 


Nearly a Rube Goldberg machine, we 
hope it plays ‘Powerhouse’ when used 


Maker Prof i le 
Emil 

Jaworski 

Maker 

Finding himself ina 
rented apartment 
for a few months, 
Emil has decided to 
upgrade it himself. 

Find out more: 

imgur.eom/a/ 

OYdPo 


There are many schools of thought regarding your 
sleeping environment to help aid better and more 
restful sleep. No electronics in the bedroom, try and 
relax before going to sleep, take a cool or hot shower 
depending on the time of the year. Some people 
require pitch darkness to get a good night’s sleep 
though, while others like to wake up when the sun 
rises as part of a natural body reaction. Emil likes to 
do both of these things with his Raspberry Pi that 
automatically shuts and opens his blinds at specific 
times of day: 

“7:30: Press up button, wait 10 seconds (I have 
smaller windows on the bottom and bigger above 
them, soafterthese 10 seconds, shutters are goingto 
be open only on the bottom ones), press stop button. 
8:00: Press up button. 22:00: Press down button.” 

Unfortunately, it means he has some electronics in 
his bedroom, but whateverworksfor him, 


r 


RasPi Terminal 


We’ve had lots of Raspberry Pi over the 
years, but what about Apple Pi? 


Maker Prof i Le 

Austen 

Barker 

Engineering 

student 

A Californian 
student that has 
a habitof messing 
around with any old 
computer hardware 
that he can get his 
hands on. 

Find out more: 

imgur.eom/a/ 

vOsML 


“In my spare time I like messing around with older 
computer hardware that I come across. Originally 
I found the need for a terminal to connect over 
SSH to a server that I was using for an internship. It 
was more efficient than devoting a more powerful 
machine to it I took a server to school with me to 
continue working forthe same company as I studied. 

I had a Raspberry Pi also sitting around and I 
started hooking it up to a monitor from an Apple lie 
that I found at my university’s electronics surplus. 
This became valuable when I started having to log in 
to a school server over SSH to compile assignments 
for my programming classes. Eventually, I found a 
keyboard from a Macintosh 512k and made it work 
over USB with a microcontroller and a custom wired 
key matrix, and I paired it with the monitor and Pi.” 
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Alarm Clock Robot 

Chasing your damn clock may sound like a 
nightmare to some, but here it is in reality 



There are many ways to get kids excited 
with coding, tike making games in Scratch, 
modifying Minecraft and teaching via 
robotics. The latter is a new concept but 
still has the same merits - a physical 
creation that children are excited about and 
react to the programming they’ve done on 
it. Visible results and instant gratification is 
a great way to get imaginations fired up. 


When we talked about Roily the alarm clock 
robot around the office, most people burst 
forth with a string of expletives not fit for print. 

t's a delightfully evil invention - an alarm clock 
you need to work for to turn off. It sounds Like a 
great invention, getting peopLe who have trouble 
waking up to actually get up out of bed arid start 
the morning. 

Like any other Dexter Industries robot, it runs 
on BrickPi, the LEGO Mindstorms adapter for 
the Raspberry Pi that enables it to interface with 
LEGO kits via programming. 

“Today almost everyone uses their phone as 
an alarm clock, which has a range of benefits," 
the website explains. “Phones are easy to 
set, easy to adjust, play custom songs and 
can even sense when is the best time to wake 
you up. The problem is, unless your phone is 
across the room, we use our phones so much 
we can literally use them in our sleep. Why not 
build a robot that is able to do all these things, 


Taryn Sullivan 

Advisor 


CL 


Taryn is an international, businesswoman. As well 
as flying between Shanghai and DC for her own 
engineering business, she now works with Dexter 
Industries to promote robotics education. 

Find out more: bit.iy/iBTYijv 


but won’t stop till you get up and start moving! 
Our robot will be able to easily move randomly 
around the room over any surface, playing a 
custom alarm tone. 

“In order to set the alarm, simply link the 
program on the BrickPi to your Google account 
and it will search events with the title ‘wakel’ 
and automatically startthe alarm at the event’s 
time. This means the alarm time can very easily 
be adjusted using any device that can access 
your Google Calender." 


, y ' 


PiFM Radio 

Sometimes the simplest hacks can 
open up whole worlds of possibility 


Ras Pi Smart TV 

Is your smart TV not smart enough? 
Open the case and put a Pi inside 


Maker Profile 
Oskar Weigl 

Electronics 

engineer 

Oskar is an 
electronics 
professional and 
hobbyist, as well as 
an avid forward 
and reverse 
engineer. 

Find out more: 

bit.ly/lomGBQE 


When studying at Imperial College London, 
Oskar Weigl and Oliver Mattos turned the Pi 
into an FM radio by connecting a wire (antenna) 
toGPI04and using a custom Python module. 

“There is a clock generation module in the 
hardware of the Raspberry Pi chip that lets 
you output a clock signal at a user-selected 
frequency,” Oskar explains. “We used the DMA 
controller to send commands to the clock 
module to change the frequency and achieve 
frequency modulation. We had to overclock 
the clock generation module by a factor of 20. 
The sound is 14 bits per sample, enhanced to 
a higher number using delta sigma modulation 
and the range is at least 50 metres.” 


Maker Profile 
Tony Hoang 

Graduate 

researcher 

Tony Hoang is a PhD 
studenfstudying 
computational 
biophysics and 
single molecule 
research at SUN Y- 
ALbany in Albany. 

Find out more: 

Linkedin.com/in/ 

tonyphoang 


“There’s plenty of room for additional electronics 
inside the Hisense LED smart TV,” begins Tony 
Hoang. “There’s a large flat area for electronic parts 
in the centre of the TV where I placed my Raspberry 
Pi. The dual down-facing speakers were quite Loud, 
so I removed one and replaced it with a USB hub. The 
back panel was mostly flat, so finding a spot for the 
LAN port and HDMI output was n’t too hard. 

“The Raspberry Pi is powered by the logic board 
of the Hisense. There were the obvious 5v-500 mAh 
outputs from the 2x USB 2.0 ports, which I tried but 
I found out that the logic board shuts off the power 
to these ports when the TV turns off. To keep the 
Raspberry Pi turned on, I probed the logic board with 
a multimeterand found one from an unused GPIO." 


i 
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Astrogun 


An augmented reality light gun game 


Walking around Maker Faire, you see some 
weird and wonderful things. If you'd been 
present at the Jerusalem Maker Faire you 
may have seen people wield a giant toy gun to 
shoot down virtual asteroids in Avishay’s AR 
motion game Astrogun. 

“In the Astrogun lies a Raspberry Pi 
computer,” Avishay explains. “An IMU card 
connected to it (Sparkfun’s MPU-9150 
breakout board) gives it the ability to sense 
the unit’s orientation. The Pi is then able to 
draw the elements seen from that angle. 


When the player moves, the graphics move, 
givingthe ‘object in the room’ sense." 

Why the Raspberry Pi? It was due to time, 
according to Avishay: “I had a short time to 
bring it to a working thing, so I had to pick a 
platform that was capable of the task and 
easy to use. The RPi fits that criteria. I used 
many software components designed for the 
RPi or tested on it - the Pi3D and RTiMULib. 
The combination of Pi as a hardware platform 
and Python as a programming language is 
the fastest way to materialise ideas." 


Below Clever software 
jives you a window onto the 
Astrogun gameworld 


! Maker Profile 

Avishay 
Orpaz 

Electronics 
engineer 

Find out more: 

bit.ly/lAYPSqg 


Pirate TV 


■ « 




20- (Stic 


Go all the way and totally rebuild Android TV! 


Maker Profile 

Donald Derek 
Haddad 

Software 

engineer 

Donald is an open 
source hacker. 

Find out more: 

donaldderek.com 


The perfect companion to the Smart TV 
hack, Donald Derek Haddad’s project is a 
customTV interface you can make yourself. 

“Pirate TV is a smart television 
application that runs on the Raspberry 
Pi with the Raspbian OS,” Donald tells 
us. “It’s built with open source tools and 
shipped with a free remote controller, 
your mobile device. At its core lies a Node, 
js application that runs a web server with 
Express.js/Socket.io to handle users 


requests from the remote and trigger shell 
scripts. The TV user interface is rendered 
on a Chromium instance in kiosk mode. 
Videos are streamed from YouTube or other 
channels played on OMXPlayer, and cached 
including 1080P HD content. This project is 
a work in progress and it’s not going to be 
able to tap into a lot of the content, which 
makes a Google (now Android) TV or other 
commercial platforms so valuable.” Check 
out Derek’s tutorial: bit.ly/1l6YKpj. 


Pye Radio 


Old meets new in this modified radio 


Maker Profile 
Tony Flynn 

Senior embedded 
systems design 
engineer 

Find out more: 

bit.ly/19zrgPl 


Upcycling is a great concept: recycling a 
product using new technology to make 
it relevant in the modern world. While 
standard analogue radio isn’t dead yet, its 
nice to have options when listening to music. 
This is where Tony’s idea came in: 

“I’d been working on a Raspberry Pi to play 
music streams through my stereo. Once this 
was running I integrated the Raspberry Pi into 
an old radio named a Pye! With a background 
in woodwork and engineering this seemed 
like the perfect project.” 


However, this project wasn't a walk in 
the park for Tony: “The hardest part of the 
conversion is linking the tuner knob to the 
rotary encoder. For this radio I used the 
spring from an old biro as a drive train to link 
the tuner knob spindle to the rotary encoder 
through 90 degrees.” 

Did Tony have qualms about heavily 
modifying such a classic design? “None 
whatsoever! Some people don’t like the 
modern style now stamped on this old radio, 

I think it’s a new era, new look!” 



Right 
The body 
has also been 
cleaned and repainted 
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Classic aesthetics with modern 
convenience, this old-school 
camera has been upgraded 

with a Raspberry Pi 



Pete Taylor 

Web manager 

H + l + l + b* kitfe-l-ii-l^tl-fca + a + fl + a + l-f-l + fi + l + l + l + l-t I -tk-tfari-fcd + ri + i + i + a + l + l + l + k + fi + l k 

Pete works for a charity and has always tinkered 
with computers, ever since he got a hand-me- 
down BBC computer. He likes that the Raspberry 
Pi retu rns to a ti me when you could hack your own 
computer without making an expensive mistake. 


k. 


Find out more: bit.iy/iMKRASw 
I / 


■HThe Raspberry Pi is 
a maker’s dream - it’s 


cheap and cheerful, 
and the community 
built around it is a 
brilliant resource 



Old cameras have a very specific design 
aesthetic that it seems has been lost to 
time, although nostalgia for them is still very 
strong in certain circles. Unfortunately, while 
nostalgia, desire and working cameras still 
exist in the 21st Century, usable film is quickly 
dwindling in supply. So if you like the aesthetic 
and aren’t too bothered about using the old 
photo process, why not upgrade the insides 
with more modern technology? 

"I wanted a suitable case for the Raspberry 
Pi camera board,” Pete tells us, “and the Holga 
seemed a perfect fit, Most of the available 
cases are either a bit ugly or suited more 
towards stationary webcam-type applications.” 

Why the Raspberry Pi, though? 

“The Raspberry Pi is a maker’s dream - 
it’s cheap and cheerful, and the community 
that’s built up around the Pi makes a brilliant 
resource when you're stuck with a problem or 
want to find out more.” 

The entire build doesn’t require a massive 
amount of components either. As well as 


the actual camera and Pi itself, Pete used a 
Raspberry Pi camera board to actually take 
photos, a Wi-Fi module for connecting to it 
remotely, a battery and a switch for it, and 
a few buttons and resistors to wire up the 
camera’s control buttons to the Pi. 

“it works better than I expected!” Pete said 
about the quality of the finished product. 
“Although it seems a bit daft to build a camera 
that’s about as good as you’d get from a cheap 
camera phone, it’s changed the way ! take 
pictures. By removing the instant replay - most 
people seem to view the world through the 
displays on their phones - I can concentrate on 
taking the photo. Only seeing the pictures when 
I’ve taken the camera home and downloaded 
them to my PC adds a bit to the film nostalgia 
and I’m often surprised by the photos I’ve 
taken. Plus I’ve received some nice feedback 
about how the camera looks." 

This is only the first iteration, and Pete has 
plans to make the next buiLd easier and also 
use the original lens with the Pi camera. 


Do it yourself 

Version two of the project will result in a kit 
that people can use to convert their own 
cameras “thatdoesn’t require you to take 
a Dremeltothe insides of a Holga!”. He’s 
not decided yet on whether to make a kit 
that converts a Holga, ora kit that builds a 
Holga-esque case around the Raspberry 
Pi itself. Either way, the whole thingshould 
also have a better photo-takingcapability, 
which is the ultimate goal. 





Top-left The 
camera of the 
past, updated 
for today 

Left T he Pi is 
the perfect size 
to fit inside the 
camera case 
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BHcoin Pool Table 

Modem pool pros pay digitally by 
scanning a QR code to insert Bitcoins 

Liberty Games loaded a Raspberry Pi into the side of 
a pool table that enables people to make payments 
via a Bitcoin app on their phone to release the balls. 

“We did this with the Raspberry Pi 1", Stuart tells 
us. “We tried to install the entire Bitcoin client on 
the Pi but it was struggling, and downloading the 
whole blockchain caused issues too. it was going to 
be connected to the Internet, so we offloaded the 
heavier work to a server able to handle the blockchain. 
The server receives the Bitcoin payment and then 
communicates to the Pi securely that the payment 
has come in, and it syncs up the prices as well. 

“We connected a Pi Face via a breakout board 
that’s monitoring on WebRCT for the go-ahead from 
the server, and once it gets that, it sends the physical 
voltage to the electrical ball release mechanism." 


Maker Profile 
Stuart Kerr 

Technical 

director 

Stuart Kerr is the 
techn ical director 
of Liberty Garries, 
which specialises in 
classic table and bar 
games. You might 
have heard of some 
of their hacks. 

Find out more: 

li bertygamesxo.uk 



Above The price of a game is displayed, in 
Bitcoins, on the PiFace display module 



Ian Cole and his sons 






'e boards with Fireball t 



Maker Profile 
Ian Cole 

Maker and 
geek raiser 

Ian Cole is a keen 
mak.er r hacker 
and inventor, and 
regularly blogs 
about his family 
projects with his two 
sons. Their Fireball 
project, for example, 
grew out of an 
innocent k Can you 
make it playable?' 

Find out more: 

raisinggeeks.com 


At raisinggeeks.com, Ian Cole and his two sons 
love a challenge. So the chance to repair a game 
table gave them the perfect Raspberry Pi primer. 

“We’ve taken an existing pinball machine 
playfield,” says Ian, "and built a new game from 
it. This required learning the underlying hardware 
first. Then we learned how to use the Raspberry Pi, 
pygame for sound and text graphics, and omx player 
for HD video, and we connected the software tools 
with the hardware of the pinball machine, 

“We built a MOSFET circuit on a breadboard 
to test a single solenoid. When that worked, we 
duplicated it onto a hand-soldered protoboard 
and extended it to control the five solenoids. The 
Raspberry Pi handles graphics, audio, scoring ruLes, 
saving scores, etc. One Arduino drives the lamp and 
switch matrix, another drives the solenoids. The 
three are connected with an I2C bus." 


r 




Maker Profile 
MikelDuke 

Software 

developer 

Mikel loves 
programming, 
photography, biking 
and hi king, and 
sharing his projects. 

Find out more: 

bit.Ly/IFOHDkW 


Mikel found himself in a quandary: he 
didn’t have a coffee table. However, 
instead of just heading to ikea and 
picking up a LACK, he decided to 
make one himself. Not just any coffee 
table though, one that lit up using a 
Raspberry Pi to control the sequence. 

“I used the Raspberry Pi because it 
was easy to work with and has a great 
community. Whenever I run into an 
issue, there is always documentation 
on how to fix it. I wanted to have 


network support and do more complex 
operations, like loading images, than 
I could do just using an Arduino with 
Ethernet, The combination of the 
two really made development faster. 
Now that Pi4J has added support for 
the Raspberry Pi’s integrated SPI, I 
am working on controlling the LEDs 
directly, without the Ard uino.” 

Recently, Mikel added voice control 
to it using Google Now. “After you say 
a command to Google Now, Autovoice, 


a plugin for the Android app Tasker, 
intercepts the response back from 
Google. If the response matches a 
Tasker task, the task will be launched. 
I have a few tasks set up to make web 
service calls, basically calling a URL 
with parameters. This URL connects 
to a Java based web service I created, 
running on my Raspberry Pi.” 

Mikel also encourages users not to 
use coasters, as drinks light up well 
when the table is switched on. 


r ^ 
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FinSerprint 

U1.0 


4 



Above Alarm 


mode can only 
be disabled with 
the right finger or 
the master code 


Project Ja rvis 

The 1950s future today with your 
voice-activated smart home 
automation system 


> 

May ur Singh 

Computer systems engineering student 

a + a + B + B + B + a + B + a-i-Ba-Ba-fei + ri + a + l + a + B + B + a + B + B + B + Bfl-BBfcil-fci + aBia + a + ri + a + B + B + B a 

Located in South Africa, Mayur’s expertise is 
in embedded systems and heisfamiliarwith 
microcontrollers and systems that enable 
outside hardware interaction, such as the 
Raspberry Pi and the Beaglebone Black. 

Find out more: bit.iy/iEvimci 
1 / 

Home automation has been a thing for years 
now, with a fair few intrepid engineers and 
DIYers modifying their home. With wirelessly 
controlled lights, heating, garage doors and 
many other household items, it’s amazing what 
some have achieved. Science fiction has always 
portrayed houses with advanced systems and 
Mayur has been busy creating such a system. 

“The major inspiration came from watching 
the Iron Man movies, which is where the name 
Jarvis comes from. ! decided to build a simple 
home automation system, however over the 
many years and many reinstalls of Windows, 

I lost my program, i built a new and improved 
home automation system, which features an Al 
assistant and more functionality, after I saw the 
third Iron Man film." 

While home automation is one part of the 
project, convenience isn't the only factor. 

“The main function of the system is to 
help save energy in homes,” Mayur tells us. 
“Jarvis can read and monitor the electricity 



■BThe Raspberry Pi is 
a maker’s dream - it’s 


cheap and cheerful, 
and the community 
built around it is a 


brilliant resource 




Left The Jarvis 
interface is 
gorgeous, but 
you can control 
the system from 
anywhere using 
your smartphone 
oryourvoice 


usage per light or appliance and this lets the 
A! perform certain tasks. These tasks are 
determined by outside factors, like whether 
or not a light should be switched on if there 
is adequate natural light in the room. This is 
a basic example but other factors influence 
the determination of the Al, which has control 
over the power to each light or appliance. The 
data is logged throughout the month and the 
system uses that information to achieve better 
results the following month. This is smart 
home automation.” 

The Jarvis Al is a major part of it, and you can 
talk to it. “He can control your home using voice 
interaction and make basic decisions about 
energy savings in a room. I have also recently 
built a wall-mounted tablet system that links 
to a local online grocery store. It uses voice 
control to identify what products you need and 
adds the items to a list until you specify the 
delivery.” 

With a year and a half of work on the project, 
everything Mayur has completed works 
reliably, but there are still more functions he 
wants to add. 


The voice 

The Jarvis that this project is named after 
is well-known for its snarky remarks and 
tone of voice. Choosing an actual voice that 
works though is a hard enough task without 
goingfor a certain style, as Mayur explains: 

“it’s been difficult trying to find voices with 
a good API and price but I have settled for a 
free API which offers cloud conversion and 
just sends an MP3 sound file back, it takes 
longer but it ensures that the voice works 
on all OSs.” 

If you ’re interested in having a go at creating 
your own Jarvis-esque home automation 
system then thankfullyyou’re in luck. You 
can check out Joey Bernard’s extensive 
three-part series (beginning on page 76 of 
this very book) that explains howto set up 
a digitalassistantthat uses Pyaudio and a 
few voice recognition modules in order to 
parse your spoken commands. 
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Portable 
Pi Arcade 


Love old arcade games? 

With Ben Heck's hack, you can play them all 
on a single hand-built, hand-held console 



Above Install MAM E and 
you will never run out of 
arcade games to play 


O 

s^_ 

CL 


Ben Heck 

Master hacker, creator 

of The Ben Hec k Show 


7 


rP* 


Ben Heck is an online sensation and a pillar of 
the maker community, puttingout amazing 
how-to videos for games console hacks and all 
kinds of different Pi projects. He ? s done it all. on 
The Ben Heck Show : 

Find OUt more: benheck.com 


Heck's hacks 

Pi Point and Shoot: A Raspberry Pi camera 
module, PiTFT from Adafruit, PlayStation 3 
controller battery and additional parts were 
all made into a point-and-shoot camera. 

Pi Retro Computer: A tribute to the BBC 
Microcomputer from the 1980s, Ben 
mounted a Raspberry Pi to a self-made 
wooden case, HDMI port, on/off switch and 
USB hub for an ‘old -school’ feel computer 
and carrying case. 

Handheld Pi Console: Ben hacked a 
Raspberry Pi single board computer 
to make it smaller. Combined with a 
composite LCD wireless keyboard, lithium 
battery power source and USB joystick, he 
created a handheld gaming console. 


Ben Heck has built two versions of the 
Portable Pi Arcade. The first was the original 
Portable Raspberry Pi project (youtube.com/ 
watch?v=dUZjzQuTNX4), where he hacked the 
Pi to reduce its size and opened up a USB game 
controller to extract the circuits. With a new 
assembly in place, he 3D-printed a custom- 
designed case, put the new device together, and 
booted up MAME (the Multiple Arcade Machine 
Emulator) to play old-school games. 

His recent revival of this earlier project was 
even more home-made. For the Raspberry Pi 
MAME portable gaming device (youtube.com/ 
watch?v=zrEj1aQRbpw), Ben made a circuit 
board from scratch, fitting all the components 
into a new 3D -printed case that, rather than 
resembling a Game Gear, looks pretty close to 
a Game Boy. 



Above Watch the video to see how Ben build 
and tests the custom circuit board 


We asked Ben to take us through the original 
version of his project: “My first portable Pi project 
was a small, battery-powered unit for gaming," 
he begins, "It had a single USB port for Wi-Fi 
or external storage and we featured it back on 
season three of the show. The screen came from 
a cheap NTSC LCD screen that Amazon sells 
for use as a car’s backup camera. The buttons I 
laser-cut myself and the case was 3D-printed." 
And in terms of physical modifications to the 
Pi? “Mostly I removed the taller through-hole 
components,” he replies, “and attached the 
Teensy HID (used for controllers) directly to it. I 
also moved the secondary USB port.” 

As you can see above, the case is very well 
made. “I did the initial layout in Adobe ILlustrator, 
for the laser-cut portions," explains Ben, “then 
transferred the whole design to Autodesk 123D 
to create a 3D-printable file. Hand-writing 
the buttons for the controls was the most 
challenging part of this project. It was the 
most time-intensive part and required a lot of 
precision and attention to detail." 

Ben is no stranger to taking apart consoles 
and controllers for his Pi hacks - but he also 
makes one-handed accessibility controllers. “In 
addition to all of the other projects and hacks, 
we modify gaming controllers for people who 
have difficulty using existing ones," Ben tells 
us. “On the show we’ve featured a few of them 
- Xbox One, PS4, even the Wii. Now we build 
these controllers by request and they can be 
ordered off my website, though we only do Xbox 
360/Xbox One controllers as those use PCBs 
throughout (instead of silk screen circuits like 
the PS4). Recently I trained Felix (an assistant on 
element14’s The Ben Heck Show) on howto do it, 
so he’s been helping and working on them in his 
spare time as well.” 
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Become a Linux genius with this essential guide to mastering 
open source software. Packed with fantastic coding projects to 
help you secure your network, encrypt emails and much more, 
this is a must-have for any Linux user. 
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for Beginners 


Whether you love gaming, history 
animals, photography, Photoshop, 
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expert advice and fascinating facts. 
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